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.
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 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.
Cuidado
As APIs de Reunião Online do Graph que suportam o evento em direto do Microsoft Teams foram preteridas e deixarão de funcionar a 30 de setembro de 2024. As novas Graph APIs irão substituí-lo na Primavera de 2024. Para obter mais informações, veja Descontinuação da API de eventos em direto do Teams no Microsoft Graph.
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. |
| allowMeetingChat | meetingChatMode | Especifica o modo de conversa de reunião. Herdado de onlineMeetingBase. |
| allowParticipantsToChangeName | Booliano | Especifica se os participantes têm permissão para mudar o nome numa instância da reunião. |
| chatRestrictions | chatrestrictions | Especifica a configuração para restrições de chat de reunião. |
| 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. |
| allowRecording | Booliano | Indica se a gravação está ativada para a reunião. Herdado de onlineMeetingBase. |
| allowedPresenters | onlineMeetingPresenters | Especifica quem pode ser um apresentador numa 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. |
| 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 .
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.
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. |
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. |
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.
- O tipo de registo só pode ser externalMeetingRegistration, que herda de meetingRegistrationBase. O tipo meetingRegistration foi preterido e deixará de devolver dados a 31 de julho de 2024.
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"allowAttendeeToEnableCamera": "Boolean",
"allowAttendeeToEnableMic": "Boolean",
"allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"},
"allowTeamworkReactions": "Boolean",
"allowedPresenters": "String",
"anonymizeIdentityForRoles": ["String"],
"audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
"chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
"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": "microsoft.graph.meetingChatHistoryDefaultMode",
"startDateTime": "String (timestamp)",
"subject": "String",
"videoTeleconferenceId": "String",
"watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}
Comentários
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: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários