Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les API des événements virtuels Microsoft Graph vous permettent d’obtenir les données de l’hôtel de ville Teams et de créer, mettre à jour et annuler une assemblée générale Teams par programme.
Pour que vous utilisiez au mieux les API de l’hôtel de ville d’événements virtuels Microsoft Graph, il est utile de comprendre les personnages des utilisateurs qui accèdent à l’expérience de l’hôtel de ville Teams :
- Les organisateurs sont des employés (dans votre organization) qui gèrent la mairie. Ils sont l’autorité sur le moment où les assemblées ont lieu et qui y participe. Ils configurent les détails de l’assemblée générale, tels que le titre, le thème, l’expérience des participants et les règles de messagerie.
- Les présentateurs sont des employés (dans votre organization) ou des invités qui dirigent l’assemblée publique.
- Les participants sont soit des employés (dans votre organization) soit des invités qui rejoignent la mairie et sont invités par e-mail ou le lien vers l’événement de la mairie est partagé avec eux.
- L’administrateur client Teams doit autoriser les applications personnalisées avec les autorisations appropriées.
Vous pouvez utiliser les types de ressources suivants pour créer votre solution d’hôtel de ville :
- virtualEventTownhall : permet de créer, d’obtenir, de mettre à jour, de publier et d’annuler une mairie Teams.
- virtualEventPresenter : permet de créer, d’obtenir, de répertorier, de mettre à jour et de supprimer un présentateur pour une assemblée générale Teams.
- virtualEventSession : une assemblée générale créée via les API Microsoft Graph a une session qui hérite des propriétés des réunions en ligne.
Solutions que vous pouvez créer
Le tableau suivant répertorie certaines solutions que vous pouvez créer à l’aide du client Teams et des API et webhooks de l’hôtel de ville Microsoft Graph.
| Solutions | Description |
|---|---|
| Créer/mettre à jour/annuler | Créez, mettez à jour et annulez l’assemblée générale Teams par programmation. |
| Synchronisation des données | Extrayez les données de l’hôtel de ville Teams dans une application personnalisée. |
| Email communication | Utilisez votre propre infrastructure de messagerie pour envoyer des e-mails de notification liés aux mairies. |
Remarque
Pour créer des solutions Microsoft Graph, vous devez vous inscrire et accorder les autorisations appropriées à votre application. Pour plus d’informations, consultez Principes de base de l’authentification et de l’autorisation.
Consentement spécifique à la ressource (RSC) pour les événements virtuels
Le consentement spécifique aux ressources (RSC) permet aux applications de demander des autorisations limitées à un webinaire ou à une assemblée publique spécifique au lieu d’exiger des privilèges d’administrateur général. Les autorisations RSC améliorent la sécurité, simplifient les flux de consentement et permettent aux développeurs de créer des intégrations qui respectent les limites de l’organisation.
API d’événements virtuels Microsoft Graph activées et autorisations RSC
| Autorisation RSC | API | Description |
|---|---|---|
| VirtualEvent.Read.Chat | Webinaire et assemblée générale | Lisez les informations relatives à ce webinaire ou à cette assemblée générale, notamment les horaires, les intervenants, les paramètres d’événement et les inscriptions au webinaire. |
| OnlineMeetingArtifact.Read.Chat | Rapport de présence et enregistrement de présence | Lisez les rapports de présence et les enregistrements de présence pour ce webinaire ou cet hôtel de ville. |
| VirtualEventRegistration-Anon.ReadWrite.Chat | Inscriptions d’événements virtuels | Inscrivez les participants et annulez les inscriptions pour ce webinaire. |
Flux d’authentification traditionnel
Si RSC n’est pas obligatoire ou réalisable, vous pouvez utiliser les flux OAuth traditionnels suivants :
- Flux de jetons d’application uniquement : utilisez-le pour les services principaux ou les scénarios d’automatisation où l’application agit sans contexte utilisateur.
- Flux de jetons délégués (utilisateur) : à utiliser lorsque les actions nécessitent le contexte et le consentement de l’utilisateur.
Quand utiliser le flux de jetons RSC par rapport au flux de jeton traditionnel
| Scénario | Approche recommandée |
|---|---|
| L’application a besoin d’accéder à un webinaire ou à une assemblée générale spécifique uniquement | RSC |
| L’application nécessite un accès à l’échelle du locataire à plusieurs événements | Flux de jetons d’application uniquement |
| Actions pilotées par l’utilisateur, telles que la gestion des événements par l’organisateur | Flux de jeton délégué |
| Les mandats de conformité ou de sécurité nécessitent des privilèges minimum | RSC |
Prise en main des autorisations RSC
Les étapes suivantes décrivent comment commencer à configurer votre application et à utiliser les autorisations RSC :
- Inscrivez votre application et définissez des autorisations RSC dans le manifeste de l’application.
- Publiez votre application via le portail des développeurs Teams ou l’Espace partenaires.
- Administration accorde RSC dans le centre d’administration Teams.
- Utilisez les API Microsoft Graph pour les webinaires et les assemblées avec des autorisations étendues.
Créer/mettre à jour/annuler
- Utilisez l’API Créer une mairie pour créer un brouillon de l’événement, suivie de l’API Publier une mairie pour terminer la création et la rendre visible par son public.
- L’assemblée générale créée via les API Microsoft Graph est un événement d’assemblée générale Teams visible et modifiable dans le client Teams.
- Comme dans Teams, seul l’organisateur peut créer, publier et annuler des assemblées. L’API create townhall prend uniquement en charge les autorisations déléguées au nom de l’organisateur.
- Comme dans Teams, les coorganiseurs peuvent mettre à jour les mairies. Pour mettre à jour une assemblée publique, utilisez l’API Mettre à jour la mairie avec des autorisations déléguées pour le compte du coorganiseur.
Synchronisation des données
- Utilisez l’API Get townhall pour extraire des données concernant une assemblée publique spécifique, par exemple qui est invité, qui a créé l’assemblée et qui sont les coorganiseurs.
- Répertorier toutes les mairies d’un locataire, y compris les mairies pour lesquelles l’utilisateur est organisateur ou coorganisateur. Ce scénario est pris en charge pour les autorisations déléguées et d’application . Ces API sont actuellement disponibles uniquement dans le point de terminaison bêta.
Email communication
Vous pouvez désactiver les communications par e-mail aux participants lorsque vous créez l’assemblée générale. Dans la propriété settings , définissez sur isAttendeeEmailNotificationEnabledfalse. Les e-mails sont toujours envoyés aux organisateurs, coorganiseurs et présentateurs (internes et externes).