Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
-
userIdé a ID de objeto de um usuário na página de gerenciamento de usuários do centro de administração do Microsoft Entra>. Para obter mais informações, consulte política de acesso ao aplicativo. -
meetingIdé a ID de um objeto onlineMeeting .
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 comopresenterno 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
}
}