Partilhar via


Atualizar onlineMeeting

Namespace: microsoft.graph

Atualize as propriedades do objeto onlineMeeting especificado.

Veja a secção Corpo do pedido para obter a lista de propriedades que suportam a atualização.

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

As tabelas seguintes mostram as permissões ou permissões com menos privilégios necessárias para chamar esta API em cada tipo de recurso suportado. Siga as melhores práticas para pedir permissões com menos privilégios. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Permissões para o seguinte pedido HTTP:

PATCH /me/onlineMeetings/{meetingId}
Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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 o seguinte pedido HTTP:

DELETE /users/{userId}/onlineMeetings/{meetingId}
Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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 utilizar a permissão de aplicação para esta API, os administradores inquilinos têm de criar uma política de acesso à aplicação e concedê-la a um utilizador para autorizar a aplicação configurada na política a atualizar reuniões online em nome desse utilizador (com o ID de utilizador especificado no caminho do pedido).

Solicitação HTTP

Para atualizar o onlineMeeting especificado com o ID da reunião com permissão delegada (/me) e aplicação (/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 seguinte lista as propriedades que podem ser atualizadas. No corpo do pedido, inclua apenas as propriedades que precisam de ser atualizadas, com as seguintes exceções:

  • Ajustar a data/hora de início ou de fim de uma reunião online requer sempre as propriedades startDateTime e endDateTime no corpo do pedido.
  • Não é possível atualizar o campo organizador da propriedade dos participantes . Não é possível modificar o organizador da reunião 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, requer sempre a lista completa de participantes no corpo do pedido.

A última coluna indica se a atualização desta propriedade entrará em vigor para uma reunião em curso.

Propriedade Tipo Descrição Aplica-se a reuniões em curso?
startDateTime DateTime A hora de início da reunião em UTC. Não
endDateTime DateTime A hora de fim da reunião em UTC. Não
assunto Cadeia de caracteres O assunto da reunião online. Não
participants meetingParticipants Os participantes associados à reunião online. Apenas os participantes podem ser atualizados. Não
isEntryExitAnnounced Booliano Se pretende ou não anunciar quando os autores da chamada entram ou saem. Sim
lobbyBypassSettings lobbyBypassSettings Especifica os participantes que podem ignorar a sala de espera da reunião. Sim
allowedPresenters onlineMeetingPresenters Especifica quem pode ser um apresentador numa reunião. Sim
allowAttendeeToEnableCamera Booliano Indica se os participantes podem ativar a câmara. Sim
allowAttendeeToEnableMic Booliano Indica se os participantes podem ativar o microfone. Sim
allowMeetingChat meetingChatMode Especifica o modo de conversa de reunião. Sim
allowTeamworkReactions Booliano Indica se as reações do Teams estão ativadas para a reunião. Sim
recordAutomaticamente Booliano Indica se pretende gravar a reunião automaticamente. Não

Observação

  • Para obter a lista de valores possíveis para allowedPresenters 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 do pedido.

Resposta

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

Exemplos

Exemplo 1: Atualizar startDateTime, endDateTime e assunto

Solicitação

Nota: O ID da reunião foi abreviado para legibilidade.

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"
}

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",
   "outerMeetingAutoAdmittedUsers":null,
   "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"
            }
         }
      }
   },
   "audioConferencing":{
      "conferenceId":"id",
      "tollNumber":"+1-900-555-0100",
      "tollFreeNumber":"+1-800-555-0100",
      "dialinUrl":"url"
   }
}

Exemplo 2: Atualizar o lobbyBypassSettings

Nota: O ID da reunião foi abreviado para legibilidade.

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": [],
    },
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": true
    }
}