Compartilhar via

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 gravações coleção callRecording Obtenha a lista de objetos callRecording associados a um onlineMeeting.
Listar transcrições callTranscript collection Obtenha a lista de transcrições de um onlineMeeting.

Observação

  • É necessário um token de portador para o Authorization cabeçalho de todos os métodos listados na tabela anterior. Para obter detalhes sobre como obter o token para o Authorization cabeç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, o tempo de expiração é prolongado 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.
allowCopyingAndSharingMeetingContent Booliano Indica se a cópia e partilha de conteúdo da reunião está ativada 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.
expiryDateTime DateTimeOffset Indica a data e hora em que o recurso da reunião expira. O tipo de carimbo de data/hora representa informações de data e hora com 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 O ID externo que é um identificador personalizado. Opcional.
id Cadeia de caracteres O ID predefinido associado à reunião online. Somente leitura. Herdado de onlineMeetingBase.
isEndToEndEncryptionEnabled Booliano Indica se a encriptação ponto a ponto (E2EE) está ativada para a reunião online. 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.
meetingOptionsWebUrl Cadeia de caracteres Fornece o URL para a página de opções de reunião do Teams para a reunião especificada. Esta ligação permite que apenas o organizador configure as definições da reunião. Herdado de onlineMeetingBase.
meetingSpokenLanguageTag Cadeia de caracteres Especifica o idioma falado utilizado durante a reunião para fins de gravação e transcriçã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.
sensitivityLabelAssignment onlineMeetingSensitivityLabelAssignment Especifica a etiqueta de confidencialidade aplicada à reunião do Teams.
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
aiInsights coleção callAiInsight As informações de IA geradas para uma reunião online. Somente leitura.
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",
  "allowCopyingAndSharingMeetingContent": "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)",
  "expiryDateTime": "String (timestamp)",
  "externalId": "String",
  "id": "String (identifier)",
  "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",
  "sensitivityLabelAssignment": {
      "@odata.type": "microsoft.graph.onlineMeetingSensitivityLabelAssignment"
  },
  "participants": {"@odata.type": "microsoft.graph.meetingParticipants"},
  "recordAutomatically": "Boolean",
  "shareMeetingChatHistoryDefault": "String",
  "startDateTime": "String (timestamp)",
  "subject": "String",
  "videoTeleconferenceId": "String",
  "watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}
  • Last updated on