tipo de recurso 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.
Contém informações sobre uma reunião, incluindo o URL utilizado para participar numa reunião, a lista de participantes e a descrição.
Este recurso suporta a subscrição de notificações de alteração. Para obter mais informações, consulte Subscrever reuniões online.
Herda do onlineMeetingBase.
Cuidado
As APIs de reunião online do Microsoft Graph que suportam eventos em direto do Microsoft Teams foram preteridas e deixaram de devolver dados a 30 de setembro de 2024. As novas APIs do Microsoft Graph irão substituir estas APIs na primavera de 2025. Para obter mais informações, veja Descontinuação da API de eventos em direto do Teams no Microsoft Graph.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Criar | onlineMeeting | Crie uma reunião online. |
| Get | onlineMeeting | Leia as propriedades e relações de um objeto onlineMeeting . |
| Atualizar | onlineMeeting | Atualize as propriedades de um objeto onlineMeeting . |
| Delete | Nenhum | Eliminar um objeto onlineMeeting . |
| Criar ou obter | onlineMeeting | Crie uma reunião online com um ID externo personalizado. Se a reunião já existir, obtenha as respetivas propriedades. |
| Listar transcrições | callTranscript collection | Obtenha a lista de transcrições de um onlineMeeting. |
| Listar gravações | coleção callRecording | Obtenha a lista de objetos callRecording associados a um onlineMeeting. |
Observação
- É necessário um token de portador 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 utilizador. - A hora de expiração das reuniões online está definida para 60 dias após a hora de início ou de fim da reunião. Se a reunião for atualizada ou ativada antes de expirar, a hora de expiração será prolongada por mais 60 dias.
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| allowAttendeeToEnableCamera | Booliano | Indica se os participantes podem ativar a câmara. Herdado de onlineMeetingBase. |
| allowAttendeeToEnableMic | Booliano | Indica se os participantes podem ativar o microfone. Herdado de onlineMeetingBase. |
| allowBreakoutRooms | Booliano | Indica se as salas simultâneas estão ativadas para a reunião. Herdado de onlineMeetingBase. |
| allowedLobbyAdmitters | allowedLobbyAdmitterRoles | Especifica os utilizadores que podem admitir na sala de espera. Os valores possíveis são: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue. Herdado de onlineMeetingBase. |
| allowedPresenters | onlineMeetingPresenters | Especifica quem pode ser um apresentador numa reunião. Os valores possíveis são: everyone, organization, roleIsPresenter, organizer, unknownFutureValue. Herdado de onlineMeetingBase. |
| allowLiveShare | meetingLiveShareOptions | Indica se a partilha em direto está ativada para a reunião. Os valores possíveis são: enabled, disabled, unknownFutureValue. Herdado de onlineMeetingBase. |
| allowMeetingChat | meetingChatMode | Especifica o modo de conversa de reunião. Os valores possíveis são: enabled, disabled, limited, unknownFutureValue. Herdado de onlineMeetingBase. |
| allowParticipantsToChangeName | Booliano | Especifica se os participantes têm permissão para mudar o nome numa instância da reunião. |
| allowPowerPointSharing | Booliano | Indica se o PowerPoint em direto está ativado para a reunião. Herdado de onlineMeetingBase. |
| allowRecording | Booliano | Indica se a gravação está ativada para a reunião. Herdado de onlineMeetingBase. |
| allowTeamworkReactions | Booliano | Indica se as reações do Teams estão ativadas para a reunião. Herdado de onlineMeetingBase. |
| allowTranscription | Booliano | Indica se a transcrição está ativada para a reunião. Herdado de onlineMeetingBase. |
| allowWhiteboard | Booliano | Indica se o quadro está ativado para a reunião. Herdado de onlineMeetingBase. |
| anonymizeIdentityForRoles | coleção onlineMeetingRole | Especifica cuja identidade é anonimizada na reunião. Os valores possíveis são: attendee. O attendee valor não pode ser removido através de uma operação PATCH depois de adicionado. Herdado de onlineMeetingBase. |
| audioConferencing | audioConferencing | As informações de acesso telefónico (por acesso telefónico) 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 as restrições de chat de reunião. Herdado de onlineMeetingBase. |
| creationDateTime | DateTime | A hora de criação da reunião em UTC. Somente leitura. |
| endDateTime | DateTime | A hora de fim da reunião em UTC. Necessário quando cria uma reunião online. |
| externalId | Cadeia de caracteres | O ID externo. Um ID personalizado. Opcional. |
| id | Cadeia de caracteres | O ID predefinido associado à reunião online. Somente leitura. Herdado de onlineMeetingBase. |
| isEntryExitAnnounced | Booliano | Indica se deve anunciar quando os autores da chamada entram ou saem. Herdado de onlineMeetingBase. |
| joinInformation | itemBody | As informações de associação no idioma e na variante de região especificadas no cabeçalho HTTP do pedido "Accept-Language". Somente leitura. Herdado de onlineMeetingBase. |
| joinMeetingIdSettings | joinMeetingIdSettings | Especifica o joinMeetingId, o código de acesso da reunião e o requisito do código de acesso. Depois de criar um onlineMeeting , não é possível modificar joinMeetingIdSettings . Para efetuar alterações a esta propriedade, a reunião tem de ser cancelada e tem de ser criada uma nova. Herdado de onlineMeetingBase. |
| joinWebUrl | Cadeia de caracteres | O URL de participação da reunião online. O formato do URL pode ser alterado; Por conseguinte, os utilizadores não devem depender de quaisquer informações extraídas da análise do URL. Somente leitura. Herdado de onlineMeetingBase. |
| lobbyBypassSettings | lobbyBypassSettings | Especifica os participantes que podem ignorar a sala de espera da reunião. Herdado de onlineMeetingBase. |
| meetingTemplateId | Cadeia de caracteres | O ID do modelo de reunião. |
| participants | meetingParticipants | Os participantes associados à reunião online, incluindo o organizador e os participantes. |
| recordAutomaticamente | Booliano | Indica se pretende gravar a reunião automaticamente. Herdado de onlineMeetingBase. |
| startDateTime | DateTime | A hora de início da reunião em UTC. Necessário quando cria uma reunião online. |
| shareMeetingChatHistoryDefault | meetingChatHistoryDefaultMode | Especifica se o histórico de conversas da reunião é partilhado com os participantes. Os valores possíveis são: all, none, unknownFutureValue. Herdado de onlineMeetingBase. |
| assunto | Cadeia de caracteres | O assunto da reunião online. Herdado de onlineMeetingBase. |
| videoTeleconferenceId | Cadeia de caracteres | O ID de teleconferência de vídeo. Somente leitura. Herdado de onlineMeetingBase. |
| watermarkProtection | watermarkProtectionValues | Especifica se a aplicação cliente deve aplicar uma marca d'água a um tipo de conteúdo. Herdado de onlineMeetingBase. |
| alternativeRecording (preterido) | Stream | O fluxo de conteúdo da gravação alternativa de um evento em direto do Microsoft Teams. Somente leitura. |
| attendeeReport (preterido) | Stream | O fluxo de conteúdo do relatório de participantes de um evento em direto do Teams. Somente leitura. |
| autoAdmittedUsers (preterido) | Cadeia de caracteres | A definição que especifica o tipo de participantes que são automaticamente permitidos na reunião online. Os valores possíveis são: everyone, everyoneInSameAndFederatedCompany, everyoneInCompany, invitedUsersInCompany, organizer. Somente leitura. |
| broadcastSettings (preterido) | broadcastMeetingSettings | Definições relacionadas com um evento em direto. |
| capacidades (preteridas) | meetingCapabilities collection | A lista de capacidades de reunião. Os valores possíveis são: questionAndAnswer,unknownFutureValue. |
| isBroadcast (preterido) | Booliano | Indica se este evento é um evento em direto do Teams. |
| gravação (preterida) | Stream | O fluxo de conteúdo da gravação de um evento em direto do Teams. Somente leitura. |
Cuidado
- A propriedade autoAdmittedUsers foi preterida. Em alternativa, utilize a propriedade de âmbito de lobbyBypassSettings .
- A propriedade capabilities foi preterida. Utilize a propriedade isQuestionAndAnswerEnabled de broadcastMeetingSettings .
meetingChatHistoryDefaultMode values (valores meetingChatHistoryDefaultMode)
| Valor | Descrição |
|---|---|
| tudo | Todo o histórico de conversas da reunião é partilhado. |
| none | Não é partilhado nenhum histórico de conversas de reuniões. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
valores meetingChatMode
| Valor | Descrição |
|---|---|
| habilitadas | O chat da reunião está ativado. |
| desabilitadas | O chat da reunião está desativado. |
| limitado | O chat da reunião está ativado, mas apenas durante a chamada de reunião. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
valores meetingLiveShareOptions
| Valor | Descrição |
|---|---|
| habilitadas | A partilha em direto da reunião está ativada. |
| desabilitadas | A partilha em direto da reunião está desativada. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
valores onlineMeetingPresenters
| Valor | Descrição |
|---|---|
| todos | Todos são apresentadores. Padrão. |
| organization | Todos os membros da organização do organizador são apresentadores. |
| roleIsPresenter | Apenas os participantes cuja função é apresentador são apresentadores. |
| organizer | Apenas o organizador é um apresentador. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. 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 de participantes especificada definida como presenter no corpo do pedido.
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| attendanceReports | coleção meetingAttendanceReport | Os relatórios de presença de uma reunião online. Somente leitura. Herdado de onlineMeetingBase. |
| gravações | coleção callRecording | As gravações de uma reunião online. Somente leitura. |
| transcrições | callTranscript collection | As transcrições de uma reunião online. Somente leitura. |
| meetingAttendanceReport (preterido) | meetingAttendanceReport | O relatório de participação da última sessão de reunião online. Somente leitura. |
| registo (preterido) | meetingRegistration | O registo que está ativado para uma reunião online. Uma reunião online só pode ter um registo ativado. |
Dica
- A propriedade meetingAttendanceReport foi preterida. Permanecerá em beta para retrocompatibilidade. No futuro, utilize a propriedade attendanceReports para obter relatórios de presença de uma reunião online.
- A propriedade de registo foi preterida e deixará de devolver dados a 12 de dezembro de 2024. Utilize as novas APIs do webinar. Para obter mais informações, veja Descontinuação das APIs beta de registo de reuniões do Microsoft Graph.
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"allowAttendeeToEnableCamera": "Boolean",
"allowAttendeeToEnableMic": "Boolean",
"allowBreakoutRooms": "Boolean",
"allowedLobbyAdmitters": "String",
"allowedPresenters": "String",
"allowLiveShare": "String",
"allowMeetingChat": "String",
"allowParticipantsToChangeName": "Boolean",
"allowPowerPointSharing": "Boolean",
"allowRecording": "Boolean",
"allowTeamworkReactions": "Boolean",
"allowTranscription": "Boolean",
"allowWhiteboard": "Boolean",
"anonymizeIdentityForRoles": ["String"],
"audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
"chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
"chatRestrictions":{"@odata.type": "microsoft.graph.chatRestrictions"},
"creationDateTime": "String (timestamp)",
"endDateTime": "String (timestamp)",
"id": "String (identifier)",
"isEntryExitAnnounced": "Boolean",
"joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
"joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
"joinWebUrl": "String",
"lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
"meetingTemplateId": "String",
"participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
"recordAutomatically": "Boolean",
"shareMeetingChatHistoryDefault": "String",
"startDateTime": "String (timestamp)",
"subject": "String",
"videoTeleconferenceId": "String",
"watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}