Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las API del ayuntamiento de eventos virtuales de Microsoft Graph le permiten obtener datos del ayuntamiento de Teams y crear, actualizar y cancelar mediante programación un ayuntamiento de Teams.
Para que pueda hacer el mejor uso de las API del ayuntamiento de eventos virtuales de Microsoft Graph, es útil comprender las personas de los usuarios que acceden a la experiencia del ayuntamiento de Teams:
- Los organizadores son empleados (en su organización) que administran el ayuntamiento. Son la autoridad sobre cuándo tienen lugar los ayuntamientos y quién participa. Configuran los detalles del ayuntamiento, como el título, el tema, la experiencia de los asistentes y las reglas de correo electrónico.
- Los presentadores son empleados (en su organización) o invitados que dirigen el ayuntamiento.
- Los asistentes son empleados (de su organización) o invitados que se unen al ayuntamiento y son invitados por correo electrónico o el vínculo al evento del ayuntamiento se comparte con ellos.
- El administrador de inquilinos de Teams debe autorizar aplicaciones personalizadas con los permisos adecuados.
Puede usar los siguientes tipos de recursos para compilar la solución de ayuntamiento:
- virtualEventTownhall : se usa para crear, obtener, actualizar, publicar y cancelar un ayuntamiento de Teams.
- virtualEventPresenter : se usa para crear, obtener, enumerar, actualizar y eliminar un moderador para un ayuntamiento de Teams.
- virtualEventSession : un ayuntamiento creado a través de las API de Microsoft Graph tiene una sesión que hereda las propiedades de las reuniones en línea.
Soluciones que puede crear
En la tabla siguiente se enumeran algunas soluciones que puede compilar mediante el cliente de Teams y las API del ayuntamiento de Microsoft Graph y webhooks.
| Soluciones | Descripción |
|---|---|
| Crear, actualizar o cancelar | Cree, actualice y cancele el ayuntamiento de Teams mediante programación. |
| Sincronización de datos | Extraiga los datos del ayuntamiento de Teams en una aplicación personalizada. |
| Email comunicación | Use su propia infraestructura de correo electrónico para enviar correos electrónicos de notificación relacionados con el ayuntamiento. |
Nota:
Para compilar cualquier solución de Microsoft Graph, debe registrarse y conceder los permisos adecuados a la aplicación. Para obtener más información, consulte Conceptos básicos de autenticación y autorización.
Consentimiento específico de recursos (RSC) para eventos virtuales
El consentimiento específico de recursos (RSC) permite a las aplicaciones solicitar permisos con ámbito a un seminario web o ayuntamiento específico en lugar de requerir privilegios de administrador global. Los permisos de RSC mejoran la seguridad, simplifican los flujos de consentimiento y permiten a los desarrolladores crear integraciones que respeten los límites de la organización.
API de eventos virtuales de Microsoft Graph habilitadas y permisos de RSC
| Permiso de RSC | API | Descripción |
|---|---|---|
| VirtualEvent.Read.Chat | Seminario web y ayuntamiento | Lea la información de este seminario web o ayuntamiento, incluidas las programaciones, los oradores, la configuración de eventos y los registros de seminarios web. |
| OnlineMeetingArtifact.Read.Chat | Informe de asistencia y registro de asistencia | Lea los informes de asistencia y los registros de asistencia de este seminario web o ayuntamiento. |
| VirtualEventRegistration-Anon.ReadWrite.Chat | Registros de eventos virtuales | Registre a los asistentes y cancele los registros de este seminario web. |
Flujo de autenticación tradicional
Si RSC no es necesario o factible, puede usar los siguientes flujos de OAuth tradicionales:
- Flujo de token de solo aplicación: úselo para los servicios back-end o escenarios de automatización en los que la aplicación actúa sin contexto de usuario.
- Flujo de token delegado (usuario): se usa cuando las acciones requieren el contexto y el consentimiento del usuario.
Cuándo usar RSC frente al flujo de token tradicional
| Escenario | Enfoque recomendado |
|---|---|
| La aplicación solo necesita acceso a un seminario web o ayuntamiento específico. | RSC |
| La aplicación requiere acceso en todo el inquilino a varios eventos | Flujo de token de solo aplicación |
| Acciones controladas por el usuario, como la administración de eventos del organizador | Flujo de token delegado |
| Los mandatos de cumplimiento o seguridad requieren privilegios mínimos | RSC |
Introducción al uso de permisos de RSC
En los pasos siguientes se describe cómo empezar a configurar la aplicación y usar permisos de RSC:
- Registre la aplicación y defina los permisos de RSC en el manifiesto de la aplicación.
- Publique la aplicación a través del portal para desarrolladores de Teams o del Centro de partners.
- Administración concede RSC en el Centro de administración de Teams.
- Use las API de Microsoft Graph para seminarios web y ayuntamientos con permisos con ámbito.
Crear, actualizar o cancelar
- Use la API Create townhall para crear un borrador del evento, seguido de publish townhall API para completar la creación y hacer que sea visible para su público.
- El ayuntamiento creado a través de las API de Microsoft Graph es un evento del ayuntamiento de Teams que es visible y modificable en el cliente de Teams.
- Al igual que en Teams, solo el organizador puede crear, publicar y cancelar ayuntamientos. La API create townhall solo admite permisos delegados en nombre del organizador.
- Al igual que en Teams, los coorganizadores pueden actualizar los ayuntamientos. Para actualizar un ayuntamiento, use update townhall API con permisos delegados en nombre del coorganizador.
Sincronización de datos
- Use la API Get townhall para extraer datos sobre un ayuntamiento específico, como quién está invitado, quién creó el ayuntamiento y quién es el coorganizadores.
- Enumere todos los ayuntamientos de un inquilino, incluidos los ayuntamientos para los que el usuario es organizador o coorganizador. Este escenario es compatible con permisos delegados y de aplicación . Estas API solo están disponibles actualmente en el punto de conexión beta.
Email comunicación
Puede desactivar las comunicaciones por correo electrónico a los asistentes al crear el ayuntamiento. En la propiedad settings , establezca en isAttendeeEmailNotificationEnabledfalse. Los correos electrónicos se siguen enviando a los organizadores, coorganizadores y moderadores (internos y externos).