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
Contém informações sobre uma reunião, incluindo a URL usada para ingressar em uma reunião, a lista de participantes e a descrição.
Cuidado
As APIs de reunião online do Microsoft Graph que dão suporte a eventos ao vivo do Microsoft Teams foram preteridas e pararam de retornar dados em 30 de setembro de 2024. As novas APIs do Microsoft Graph substituirão essas APIs em meados de 2025. Para obter mais informações, consulte Desativação da API de eventos ao vivo do Teams no Microsoft Graph.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Criar | onlineMeeting | Crie uma reunião online. |
| Get | onlineMeeting | Ler as propriedades e relações de um objeto onlineMeeting . |
| Atualizar | onlineMeeting | Atualize as propriedades de um objeto onlineMeeting . |
| Delete | Nenhum | Excluir um objeto onlineMeeting . |
| Criar ou obter | onlineMeeting | Crie um objeto onlineMeeting com uma ID externa personalizada. Se a reunião já existir, recupere suas propriedades. |
| Listar transcrições | Coleção callTranscript | Recupere a lista de transcrições de um onlineMeeting. |
| Listar gravações | callRecording | Recupere a lista de gravações de um onlineMeeting. |
Observação
- Um token de portador é necessário para o
Authorizationcabeçalho de todos os métodos listados na tabela anterior. Para obter detalhes sobre como obter otokenpara oAuthorizationcabeçalho, consulte Obter acesso em nome de um usuário. - O tempo de expiração para reuniões online é definido como 60 dias após a hora de início ou término da reunião. Se a reunião for atualizada ou ativada antes de expirar, o tempo de expiração será estendido por mais 60 dias.
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| allowAttendeeToEnableCamera | Booliano | Indica se os participantes podem ativar a câmera. Herdado de onlineMeetingBase. |
| allowAttendeeToEnableMic | Booliano | Indica se os participantes podem ativar o microfone. Herdado de onlineMeetingBase. |
| allowBreakoutRooms | Booliano | Indica se as salas para sessão de grupo estão habilitadas para a reunião. Herdado de onlineMeetingBase. |
| allowCopyingAndSharingMeetingContent | Booliano | Indica se a capacidade de copiar e compartilhar o conteúdo da reunião está habilitada para a reunião. Herdado de onlineMeetingBase. |
| allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Especifica os usuários que podem admitir do lobby. Os valores possíveis são: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Herdado de onlineMeetingBase. |
| allowedPresenters | onlineMeetingPresenters | Especifica quem pode ser um apresentador em uma reunião. Os valores possíveis estão listados na tabela a seguir. Herdado de onlineMeetingBase. |
| allowLiveShare | meetingLiveShareOptions | Indica se o compartilhamento ao vivo está habilitado para a reunião. Os valores possíveis são: enabled, disabled, unknownFutureValue. Herdado de onlineMeetingBase. |
| allowMeetingChat | meetingChatMode | Especifica o modo de chat da reunião. Herdado de onlineMeetingBase. |
| allowParticipantsToChangeName | Booliano | Especifica se os participantes têm permissão para renomear a si mesmos em uma instância da reunião. Herdado de onlineMeetingBase. |
| allowPowerPointSharing | Booliano | Indica se o PowerPoint Live está habilitado para a reunião. Herdado de onlineMeetingBase. |
| allowTeamworkReactions | Booliano | Indica se as reações do Teams estão habilitadas para a reunião. Herdado de onlineMeetingBase. |
| allowRecording | Booliano | Indica se a gravação está habilitada para a reunião. Herdado de onlineMeetingBase. |
| allowTeamworkReactions | Booliano | Indica se as reações do Teams estão habilitadas para a reunião. Herdado de onlineMeetingBase. |
| allowTranscription | Booliano | Indica se a transcrição está habilitada para a reunião. Herdado de onlineMeetingBase. |
| allowWhiteboard | Booliano | Indica se o quadro de comunicações está habilitado para a reunião. Herdado de onlineMeetingBase. |
| audioconferência | audioconferência | As informações de acesso ao telefone (discagem) para uma reunião online. Somente leitura. Herdado de onlineMeetingBase. |
| chatInfo | chatInfo | As informações de chat associadas a esta reunião online. Herdado de onlineMeetingBase. |
| chatRestrictions | chatRestrictions | Especifica as definições de configuração para restrições de chat de reunião. Herdado de onlineMeetingBase. |
| cloudVideoInteropInfo | cloudVideoInteropInfo | Configurações de integração de dispositivos de conferência para CVI (Cloud Video Interop). Somente leitura. Herdado de onlineMeetingBase. |
| creationDateTime | DateTime | A hora de criação da reunião em UTC. Somente leitura. |
| endDateTime | DateTime | A hora de término da reunião em UTC. Obrigatório ao criar uma reunião online. |
| expiraryDateTime | DateTimeOffset | Indica a data e a hora em que o recurso de reunião expira. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Herdado de onlineMeetingBase. |
| externalId | Cadeia de caracteres | A ID externa que é um identificador personalizado. Opcional. |
| id | Cadeia de caracteres | A ID padrão associada à reunião online. Somente leitura. Herdado de onlineMeetingBase. |
| isEndToEndEncryptionEnabled | Booliano | Indica se a criptografia de ponta a ponta (E2EE) está habilitada para a reunião online. Herdado de onlineMeetingBase. |
| isEntryExitAnnounced | Booliano | Indica se os chamadores devem ser anunciados quando os chamadores entrarão ou sairão. Herdado de onlineMeetingBase. |
| joinInformation | itemBody | As informações de junção na variante de idioma e localidade especificada no cabeçalho HTTP da Accept-Language solicitação. Somente leitura. Herdado de onlineMeetingBase. |
| joinMeetingIdSettings | joinMeetingIdSettings | Especifica o joinMeetingId, a senha da reunião e o requisito para a senha. Depois que um onlineMeeting é criado, o joinMeetingIdSettings não pode ser modificado. Para fazer qualquer alteração nessa propriedade, a reunião precisa ser cancelada e uma nova precisa ser criada. Herdado de onlineMeetingBase. |
| joinWebUrl | Cadeia de caracteres | A URL de ingresso da reunião online. O formato da URL pode mudar; portanto, os usuários não devem depender de nenhuma informação extraída da análise da URL. Somente leitura. Herdado de onlineMeetingBase. |
| lobbyBypassSettings | lobbyBypassSettings | Especifica quais participantes podem ignorar o lobby da reunião. Herdado de onlineMeetingBase. |
| meetingOptionsWebUrl | Cadeia de caracteres | Fornece a URL para a página de opções de reunião do Teams para a reunião especificada. Este link permite que somente o organizador defina as configurações da reunião. Herdado de onlineMeetingBase. |
| meetingSpokenLanguageTag | Cadeia de caracteres | Especifica o idioma falado usado durante a reunião para fins de gravação e transcrição. Herdado de onlineMeetingBase. |
| meetingTemplateId | Cadeia de caracteres | A ID do modelo de reunião. |
| meetingType | onlineMeetingType | O tipo da reunião online. Os valores possíveis são: adhoc, scheduled, recurring, broadcast, meetnow, unknownFutureValue. Somente leitura. Herdado de onlineMeetingBase. |
| participants | meetingParticipants | Os participantes associados à reunião online, incluindo o organizador e os participantes. |
| recordAutomatically | Booliano | Indica se a reunião deve ser gravada automaticamente. Herdado de onlineMeetingBase. |
| sensitivityLabelAssignment | onlineMeetingSensitivityLabelAssignment | Especifica o rótulo de confidencialidade aplicado à reunião do Teams. |
| shareMeetingChatHistoryDefault | meetingChatHistoryDefaultMode | Especifica se o histórico de chat da reunião é compartilhado com os participantes. Os valores possíveis são: all, none, unknownFutureValue. Herdado de onlineMeetingBase. |
| startDateTime | DateTime | A hora de início da reunião em UTC. |
| assunto | Cadeia de caracteres | O assunto da reunião online. Obrigatório ao criar uma reunião online. |
| videoTeleconferenceId | Cadeia de caracteres | A ID de videoconferência. Somente leitura. Herdado de onlineMeetingBase. |
| 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. |
| attendeeReport (preterido) | Stream | O fluxo de conteúdo do relatório do participante de um evento ao vivo do Microsoft Teams. Somente leitura. |
| broadcastSettings (preterido) | broadcastMeetingSettings | Configurações relacionadas a um evento ao vivo. |
| isBroadcast (preterido) | Booliano | Indica se essa reunião é um evento ao vivo do Teams. |
valores onlineMeetingPresenters
| Valor | Descrição |
|---|---|
| todos | Todo mundo é um apresentador. Padrão. |
| organization | Todos na organização do organizador são apresentadores. |
| roleIsPresenter | Somente os participantes cuja função é de apresentador são apresentadores. |
| organizer | Somente o organizador é um apresentador. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
Dica
Ao criar ou atualizar uma reunião online com allowedPresenters definido como roleIsPresenter, inclua uma lista completa de participantes com a função dos participantes especificada definida como presenter no corpo da solicitação.
valores meetingChatMode
| Valor | Descrição |
|---|---|
| habilitadas | O chat de reunião está habilitado. |
| desabilitadas | O chat de reunião está desabilitado. |
| Limitada | O chat de reunião está habilitado, mas somente durante a chamada de reunião. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
valores meetingChatHistoryDefaultMode
| Valor | Descrição |
|---|---|
| tudo | Todo o histórico de chat da reunião é compartilhado. |
| none | Nenhum histórico de chat de reunião é compartilhado. |
| unknownFutureValue | Valor sentinela de enumeração evolutiva. Não usar. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| relatórios de presença | meetingAttendanceReport collection | Os relatórios de presença de uma reunião online. Somente leitura. Herdado de onlineMeetingBase. |
| Gravações | callRecording | As gravações de uma reunião online. Somente leitura. |
| transcrições | Coleção callTranscript | As transcrições de uma reunião online. Somente leitura. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"allowAttendeeToEnableCamera": "Boolean",
"allowAttendeeToEnableMic": "Boolean",
"allowBreakoutRooms": "Boolean",
"allowCopyingAndSharingMeetingContent": "Boolean",
"allowedLobbyAdmitters": "String",
"allowedPresenters": "String",
"allowLiveShare": "String",
"allowMeetingChat": "String",
"allowParticipantsToChangeName": "Boolean",
"allowPowerPointSharing": "Boolean",
"allowRecording": "Boolean",
"allowTeamworkReactions": "Boolean",
"allowTranscription": "Boolean",
"allowWhiteboard": "Boolean",
"attendeeReport": "Stream",
"audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
"broadcastSettings": {"@odata.type": "microsoft.graph.broadcastMeetingSettings"},
"chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
"chatRestrictions": {"@odata.type": "microsoft.graph.chatRestrictions"},
"cloudVideoInteropInfo": {"@odata.type": "microsoft.graph.cloudVideoInteropInfo"},
"creationDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"expiryDateTime": "String (timestamp)",
"externalId": "String",
"id": "String (identifier)",
"isBroadcast": "Boolean",
"isEndToEndEncryptionEnabled": "Boolean",
"isEntryExitAnnounced": "Boolean",
"joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
"joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
"joinWebUrl": "String",
"lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"meetingOptionsWebUrl": "String",
"meetingSpokenLanguageTag": "String",
"meetingTemplateId": "String",
"meetingType": "String",
"participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"recordAutomatically": "Boolean",
"sensitivityLabelAssignment": {"@odata.type": "microsoft.graph.onlineMeetingSensitivityLabelAssignment"},
"shareMeetingChatHistoryDefault": "String",
"startDateTime": "String (timestamp)",
"subject": "String",
"videoTeleconferenceId": "String",
"watermarkProtection": "String"
}