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.
As APIs de eventos virtuais do Microsoft Graph permitem-lhe obter dados da câmara municipal do Teams e criar, atualizar e cancelar programaticamente uma câmara municipal do Teams.
Para que possa utilizar melhor as APIs da câmara municipal de eventos virtuais do Microsoft Graph, é útil compreender as pessoas que acedem à experiência da câmara municipal do Teams:
- Os organizadores são funcionários (na sua organização) que gerem a câmara municipal. Eles são a autoridade sobre quando as câmaras municipais ocorrem e quem participa. Configuram detalhes da câmara municipal, tais como título, tema, experiência de participante e regras de e-mail.
- Os apresentadores são funcionários (na sua organização) ou convidados que lideram a câmara municipal.
- Os participantes são funcionários (na sua organização) ou convidados que se juntam à câmara municipal e são convidados por e-mail ou a ligação para o evento da Câmara Municipal é partilhada com eles.
- O administrador inquilino do Teams tem de autorizar aplicações personalizadas com as permissões adequadas.
Pode utilizar os seguintes tipos de recursos para criar a sua solução de câmara municipal:
- virtualEventTownhall – utilizado para criar, obter, atualizar, publicar e cancelar uma câmara municipal do Teams.
- virtualEventPresenter – utilizado para criar, obter, listar, atualizar e eliminar um apresentador de uma câmara municipal do Teams.
- virtualEventSession – uma câmara municipal criada através das APIs do Microsoft Graph tem uma sessão que herda as propriedades das reuniões online.
Soluções que pode criar
A tabela seguinte lista algumas soluções que pode criar com o cliente teams e as APIs e webhooks da câmara municipal do Microsoft Graph.
| Soluções | Descrição |
|---|---|
| Criar/atualizar/cancelar | Crie, atualize e cancele programaticamente a câmara municipal do Teams. |
| Sincronização de dados | Extraia os dados da câmara municipal do Teams numa aplicação personalizada. |
| comunicação Email | Utilize a sua própria infraestrutura de e-mail para enviar e-mails de notificação relacionados com a câmara municipal. |
Observação
Para criar soluções do Microsoft Graph, tem de se registar e conceder as permissões certas à sua aplicação. Para obter mais informações, veja Noções básicas de autenticação e autorização.
Consentimento específico do recurso (RSC) para eventos virtuais
O consentimento específico do recurso (RSC) permite que as aplicações solicitem permissões no âmbito de um webinar ou câmara municipal específico em vez de exigirem privilégios de administrador global. As permissões RSC melhoram a segurança, simplificam os fluxos de consentimento e permitem aos programadores criar integrações que respeitam os limites organizacionais.
APIs e permissões RSC de eventos virtuais do Microsoft Graph ativadas
| Permissão RSC | APIs | Descrição |
|---|---|---|
| VirtualEvent.Read.Chat | Seminário Web e câmara municipal | Leia informações sobre este webinar ou câmara municipal, incluindo agendas, oradores, definições de eventos e registos de webinars. |
| OnlineMeetingArtifact.Read.Chat | Relatório de presenças e registo de presenças | Leia relatórios de presença e registos de presença para este webinar ou câmara municipal. |
| VirtualEventRegistration-Anon.ReadWrite.Chat | Registos de eventos virtuais | Registe os participantes e cancele os registos deste webinar. |
Fluxo de autenticação tradicional
Se o RSC não for necessário ou viável, pode utilizar os seguintes fluxos OAuth tradicionais:
- Fluxo de token apenas de aplicação: utilize-o para serviços de back-end ou cenários de automatização em que a aplicação age sem contexto de utilizador.
- Fluxo de token delegado (utilizador): utilize quando as ações requerem o contexto e o consentimento do utilizador.
Quando utilizar o RSC vs. fluxo de token tradicional
| Cenário | Abordagem recomendada |
|---|---|
| A aplicação só precisa de acesso a um webinar ou câmara municipal específico | RSC |
| A aplicação requer acesso ao nível do inquilino a vários eventos | Fluxo de token apenas de aplicação |
| Ações orientadas pelo utilizador, como organizador a gerir eventos | Fluxo de token delegado |
| Os mandatos de conformidade ou segurança requerem menos privilégios | RSC |
Introdução à utilização de permissões RSC
Os passos seguintes descrevem como começar a configurar a sua aplicação e utilizar permissões RSC:
- Registe a sua aplicação e defina as permissões RSC no manifesto da aplicação.
- Publique a sua aplicação através do portal do programador do Teams ou do centro de parceiros.
- Administração concede RSC no centro de administração do Teams.
- Utilize as APIs do Microsoft Graph para webinars e câmaras municipais com permissões de âmbito.
Criar/atualizar/cancelar
- Utilize a API Create townhall para criar um rascunho do evento, seguido da API Publish townhall para concluir a criação e torná-lo visível para o seu público.
- A câmara municipal criada através das APIs do Microsoft Graph é um evento da câmara municipal do Teams que é visível e editável no cliente do Teams.
- Tal como no Teams, apenas o organizador pode criar, publicar e cancelar câmaras municipais. A API create townhall só suporta permissões delegadas em nome do organizador.
- Tal como no Teams, os coorganizadores podem atualizar as câmaras municipais. Para atualizar uma câmara municipal, utilize a API Update townhall com permissões delegadas em nome do coorganizador.
Sincronização de dados
- Utilize a API Get townhall para extrair dados sobre uma câmara municipal específica, como quem é convidado, quem criou a câmara municipal, e quem são os coorganizadores.
- Liste todas as câmaras municipais num inquilino, incluindo as câmaras municipais para as quais o utilizador é organizador ou coorganizador. Este cenário é suportado para permissões delegadas e de aplicação . Atualmente, estas APIs só estão disponíveis no ponto final beta.
comunicação Email
Pode desativar as comunicações por e-mail para os participantes quando criar a câmara municipal. Na propriedade definições , defina isAttendeeEmailNotificationEnabled como false. Os e-mails continuam a ser enviados para organizadores, coorganizadores e apresentadores (internos e externos).