Atualizar reunião online

Namespace: microsoft.graph

Atualize as propriedades do objeto onlineMeeting especificado.

Para obter a lista de propriedades que dão suporte à atualização, consulte a seção Corpo da solicitação.

Observação

Se você convidar uma lista de contatos com mais de 150 membros para uma reunião, eles só poderão acessar o chat durante a reunião. Se algumas pessoas na lista de contatos forem participantes obrigatórios e o restante for opcional, adicione-os diretamente como participantes. Se você adicionar uma lista de contatos que faça o chat exceder 1.000 pessoas, você não poderá adicionar a lista. Para obter mais informações, consulte Chat em reuniões do Microsoft Teams.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

As tabelas a seguir mostram a permissão ou permissões menos privilegiadas necessárias para chamar essa API em cada tipo de recurso com suporte. Siga as práticas recomendadas para solicitar permissões com privilégios mínimos. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Permissões para a seguinte solicitação HTTP:

PATCH /me/onlineMeetings/{meetingId}
Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) OnlineMeetings.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Permissões para a seguinte solicitação HTTP:

PATCH /users/{userId}/onlineMeetings/{meetingId}
Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) OnlineMeetings.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo OnlineMeetings.ReadWrite.All Indisponível.

Observação

Para usar a permissão de aplicativo para essa API, os administradores de locatários devem criar uma política de acesso ao aplicativo e concedê-la a um usuário para autorizar o aplicativo configurado na política a atualizar reuniões online em nome desse usuário (com a ID de usuário especificada no caminho da solicitação).

Solicitação HTTP

Para atualizar o onlineMeeting especificado usando a ID da reunião com permissões delegadas (/me) e de aplicativo (/users/{userId}/):

PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}

Observação

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-type application/json. Obrigatório.

Corpo da solicitação

A tabela a seguir lista as propriedades que podem ser atualizadas. No corpo da solicitação, forneça apenas os valores das propriedades que devem ser atualizadas, com as seguintes exceções:

  • Ajustar a data/hora de início ou término de uma reunião online sempre requer as propriedades startDateTime e endDateTime no corpo da solicitação.
  • O campo organizador da propriedade participants não pode ser atualizado. O organizador da reunião não pode ser modificado após a criação da reunião.
  • Ajustar o campo de participantes da propriedade dos participantes , como adicionar ou remover um participante da reunião, sempre requer a lista completa de participantes no corpo da solicitação.

A última coluna indica se a atualização dessa propriedade terá efeito para uma reunião em andamento.

Propriedade Tipo Descrição Aplica-se a reuniões em andamento?
allowAttendeeToEnableCamera Booliano Indica se os participantes podem ativar a câmera. Sim
allowAttendeeToEnableMic Booliano Indica se os participantes podem ativar o microfone. Sim
allowBreakoutRooms Booliano Indica se as salas para sessão de grupo estão habilitadas para a reunião. Não
allowCopyingAndSharingMeetingContent Booliano Indica se a capacidade de copiar e compartilhar o conteúdo da reunião está habilitada para a reunião. Sim
allowedLobbyAdmitters allowedLobbyAdmitterRoles Especifica os usuários que podem admitir do lobby. Os valores possíveis são: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Sim
allowedPresenters onlineMeetingPresenters Especifica quem pode ser um apresentador em uma reunião. Sim
allowLiveShare meetingLiveShareOptions Indica se o compartilhamento ao vivo está habilitado para a reunião. Não
allowMeetingChat meetingChatMode Especifica o modo de chat da reunião. Sim
allowPowerPointSharing Booliano Indica se o PowerPoint Live está habilitado para a reunião. Não
allowRecording Booliano Indica se a gravação está habilitada para a reunião. Herdado de onlineMeetingBase. Sim
allowTeamworkReactions Booliano Indica se as reações do Teams estão habilitadas para a reunião. Sim
allowTranscription Booliano Indica se a transcrição está habilitada para a reunião. Herdado de onlineMeetingBase. Sim
allowWhiteboard Booliano Indica se o quadro de comunicações está habilitado para a reunião. Não
anonymizeIdentityForRoles onlineMeetingRole collection Especifica cuja identidade é anônima na reunião. Os valores possíveis são: attendee. O attendee valor não pode ser removido por meio de uma operação PATCH depois de adicionado. Herdado de onlineMeetingBase. Não
endDateTime DateTime A hora de término da reunião em UTC. Não
isEndToEndEncryptionEnabled Booliano Indica se a criptografia de ponta a ponta (E2EE) está habilitada para a reunião. Não
isEntryExitAnnounced Booliano Se deve ou não anunciar quando os chamadores entrarem ou saírem. Sim
lobbyBypassSettings lobbyBypassSettings Especifica quais participantes podem ignorar o lobby da reunião. Sim
meetingSpokenLanguageTag Cadeia de caracteres Especifica o idioma falado usado durante a reunião para fins de gravação e transcrição. Não
participants meetingParticipants Os participantes associados à reunião online. Somente os participantes podem ser atualizados. Não
recordAutomatically Booliano Indica se a reunião deve ser gravada automaticamente. Não
sensitivityLabelAssignment onlineMeetingSensitivityLabelAssignment Especifica o rótulo de confidencialidade aplicado à reunião do Teams. Não
startDateTime DateTime A hora de início da reunião em UTC. Não
assunto Cadeia de caracteres O assunto da reunião online. Não
marca d'águaProteção watermarkProtectionValues Especifica se o aplicativo cliente deve aplicar uma marca-d'água a um tipo de conteúdo. Herdado de onlineMeetingBase. Herdado de onlineMeetingBase. Não
broadcastSettings (preterido) broadcastMeetingSettings Configurações relacionadas a um evento ao vivo. Não

Observação

  • Para obter a lista de valores possíveis para allowedPresenters, allowLiveShare e allowMeetingChat, consulte onlineMeeting.
  • Ao atualizar o valor de allowedPresenters para roleIsPresenter, inclua uma lista completa de participantes com a função de participantes especificada definida como presenter no corpo da solicitação.

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto onlineMeeting atualizado no corpo da resposta.

Exemplos

Exemplo 1: Atualizar startDateTime, endDateTime e subject

Solicitação

Observação: A ID da reunião foi encurtada para facilitar a leitura.

PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "startDateTime": "2020-09-09T14:33:30.8546353-07:00",
  "endDateTime": "2020-09-09T15:03:30.8566356-07:00",
  "subject": "Patch Meeting Subject",
  "meetingSpokenLanguageTag": "en-US"
}

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-Type: application/json

{
   "id":"MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
   "creationDateTime":"2020-07-03T00:23:39.444642Z",
   "startDateTime":"2020-09-09T21:33:30.8546353Z",
   "endDateTime":"2020-09-09T22:03:30.8566356Z",
   "joinWebUrl":"url",
   "subject":"Patch Meeting Subject",
   "isBroadcast":false,
   "autoAdmittedUsers":"EveryoneInCompany",
   "participants":{
      "organizer":{
         "upn":"upn",
         "role": "presenter",
         "identity":{
            "azureApplicationInstance":null,
            "applicationInstance":null,
            "application":null,
            "device":null,
            "user":{
               "id":"8716745d-77a9-4be3-afff-009e4b81658e",
               "displayName":null,
               "tenantId":"0823831b-1f1b-424b-b90a-1caa345a742a",
               "identityProvider":"AAD"
            }
         }
      }
   },
    "sensitivityLabelAssignment": {
      "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
    },
    "meetingSpokenLanguageTag": "en-US",
    "audioConferencing":{
      "conferenceId":"id",
      "tollNumber":"+1-900-555-0100",
      "tollFreeNumber":"+1-800-555-0100",
      "dialinUrl":"url"
   }
}

Exemplo 2: atualizar o lobbyBypassSettings

Observação: A ID da reunião foi encurtada para facilitar a leitura.

PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "lobbyBypassSettings": {
      "isDialInBypassEnabled": true
  }
}

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
    "creationDateTime":"2020-07-03T00:23:39.444642Z",
    "startDateTime":"2020-09-09T21:33:30.8546353Z",
    "endDateTime":"2020-09-09T22:03:30.8566356Z",
    "joinWebUrl":"(redacted)",
    "subject":"Patch Meeting Subject",
    "autoAdmittedUsers": "EveryoneInCompany",
    "isEntryExitAnnounced": true,
    "allowedPresenters": "everyone",
    "videoTeleconferenceId": "(redacted)",
    "participants": {
        "organizer": {
            "upn": "(redacted)",
            "role": "presenter",
            "identity": {
                "user": {
                    "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
                    "displayName": null,
                    "tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
                    "identityProvider": "AAD"
                }
            }
        },
        "attendees": [],
    },
    "sensitivityLabelAssignment": {
      "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
    },
    "meetingSpokenLanguageTag": "en-US",
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": true
    }
}

Exemplo 3: Habilitar a criptografia de ponta a ponta em uma reunião online existente

O exemplo a seguir mostra como habilitar a criptografia de ponta a ponta em uma reunião online existente.

Observação: A propriedade isEndToEndEncryptionEnabled deve ser usada com as políticas do Teams para determinar o comportamento final, e as atualizações de política podem levar até 24 horas para serem aplicadas. Para obter mais informações, consulte Exigir criptografia de ponta a ponta para reuniões confidenciais do Teams.

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "isEndToEndEncryptionEnabled": true
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
  "creationDateTime": "2020-07-03T00:23:39.444642Z",
  "startDateTime": "2020-09-09T21:33:30.8546353Z",
  "endDateTime": "2020-09-09T22:03:30.8566356Z",
  "joinWebUrl": "(redacted)",
  "subject": "Patch Meeting Subject",
  "autoAdmittedUsers": "EveryoneInCompany",
  "isEndToEndEncryptionEnabled": true,
  "isEntryExitAnnounced": true,
  "allowedPresenters": "everyone",
  "videoTeleconferenceId": "(redacted)",
  "participants": {
    "organizer": {
      "upn": "(redacted)",
      "role": "presenter",
      "identity": {
        "user": {
          "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
          "displayName": null,
          "tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
          "identityProvider": "AAD"
        }
      }
    },
    "attendees": []
  },
  "sensitivityLabelAssignment": {
    "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
  },
  "meetingSpokenLanguageTag": "en-US",
  "lobbyBypassSettings": {
    "scope": "organization",
    "isDialInBypassEnabled": true
  }
}