Atualizar onlineMeeting
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Atualize as propriedades do objeto onlineMeeting especificado.
Consulte Seção Solicitar corpo para obter a lista de propriedades que dão suporte à atualização.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. 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.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | OnlineMeetings.ReadWrite | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Para usar a permissão de aplicativo para essa API, os administradores de locatários devem criar uma política de acesso de aplicativo e concedê-la a um usuário para autorizar o aplicativo configurado na política para atualizar reuniões online em nome desse usuário (com a ID do usuário especificada no caminho da solicitação).
Solicitação HTTP
Para atualizar o onlineMeeting especificado usando a ID de reunião com permissão delegada (/me
) e aplicativo (/users/{userId}/
):
PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}
Observação
- userId é a ID do objeto de um usuário em centro de administração do Microsoft Entra > página de gerenciamento de usuário. Para obter mais detalhes, confira 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, inclua apenas as propriedades que precisam ser atualizadas, com as seguintes exceções:
- Atualizar 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 participantes não pode ser atualizado. O organizador da reunião não pode ser modificado após a criação da reunião.
- Atualizar o campo participantes da propriedade participantes , como adicionar ou remover um participante à reunião, sempre requer a lista completa de participantes no corpo da solicitação.
A última coluna indica se a atualização dessa propriedade entrará em vigor para uma reunião em andamento.
Propriedade | Tipo | Descrição | Aplica-se a reuniões em andamento? |
---|---|---|---|
startDateTime | DateTime | A hora de início da reunião no UTC. | Não |
endDateTime | DateTime | A hora de término 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. Somente os participantes podem ser atualizados. | Não |
isEntryExitAnnounced | Booliano | Se deve ou não anunciar quando os chamadores ingressarem ou saírem. | Sim |
lobbyBypassSettings | lobbyBypassSettings | Especifica quais participantes podem ignorar o lobby da reunião. | Sim |
allowedPresenters | onlineMeetingPresenters | Especifica quem pode ser um apresentador em uma reunião. | Sim |
allowAttendeeToEnableCamera | Booliano | Indica se os participantes podem ativar a câmera. | Sim |
allowAttendeeToEnableMic | Booliano | Indica se os participantes podem ativar o microfone. | Sim |
allowMeetingChat | meetingChatMode | Especifica o modo de chat de reunião. | Sim |
allowTeamworkReactions | Booliano | Indica se as reações do Teams estão habilitadas para a reunião. | Sim |
recordAutomatically | Booliano | Indica se deve gravar a reunião automaticamente. | Não |
Observação
- Para obter a lista de valores possíveis para permitidosPresenters e allowMeetingChat, consulte onlineMeeting.
- Ao atualizar o valor de permitidosPresenters para
roleIsPresenter
, inclua uma lista completa de participantes com a função de participantes especificada definida comopresenter
no corpo da solicitação.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e um objeto onlineMeeting atualizado no corpo da resposta.
Exemplos
Exemplo 1: atualizar o startDateTime, endDateTime e assunto
Solicitação
Nota: A ID da reunião foi encurtada para legibilidade.
PATCH https://graph.microsoft.com/beta/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: A ID da reunião foi encurtada para legibilidade.
PATCH https://graph.microsoft.com/beta/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
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários