Choisir une API dans Microsoft Graph pour créer et participer à des réunions en ligne

  • Article

Microsoft Graph propose deux ensembles d'API qui permettent d'organiser et de participer à des réunions en ligne sur Microsoft Teams ou Skype :

Le choix se situe entre :

  • Il s’agit d’un moyen pratique de configurer une réunion en ligne dans le calendrier Outlook où les participants cliquent pour participer à la réunion, et de continuer à l’utiliser dans Teams ou Skype.
  • Intégration par programmation enrichie des fonctionnalités Teams ou Skype dans une application pour une expérience plus personnalisée.

Éléments à prendre en considération lors du choix d’une API pour votre scénario

Choisissez l’API de calendrier pour une intégration simplifiée et intégrée au calendrier Outlook qui mène à un événement de réunion en ligne dans le calendrier Outlook :

  • Support programmatique :
    • Les applications peuvent créer ou mettre à jour un événement directement en tant que réunion en ligne dans le calendrier Outlook, à l’aide d’un objet blob rejoindre une réunion Teams inséré dans l’événement de calendrier Outlook.
    • Les applications bénéficient de propriétés pour participer à une réunion sur Internet ou en utilisant la numérotation.
  • L’expérience utilisateur de l’interface utilisateur avec l’événement de calendrier créé par programme se trouve dans une parité totale avec tout événement créé via l’interface utilisateur d’Outlook :
    • Les participants peuvent choisir de se réunir en ligne ou en personne.
    • Les participants peuvent cliquer dans le blob Participer à la réunion Teams pour rejoindre la réunion sur Internet ou en composant un numéro de téléphone.
    • Les participants peuvent utiliser d’autres fonctionnalités enrichies de Teams, notamment les vidéoconférences et la salle d’attente, si elles sont configurées.

Remarque

L’intégration au calendrier Outlook suppose qu’un administrateur a configuré Outlook pour les réunions en ligne. Vérifiez le support avant d’utiliser l’API.

Choisissez l’API de communications cloud pour la flexibilité et la prise en charge d’un programme plus large :

  • Les applications offrent davantage de flexibilité pour intégrer les résultats de l’API aux activités sectorielles et d’autres applications. L’API est dissociée d’un calendrier spécifique et ne crée pas d’événement dans un calendrier.
  • Les applications peuvent offrir les fonctionnalités suivantes aux participants :
    • Informations de jointure basées sur des paramètres régionaux.
    • Participer à une réunion sur Internet ou en utilisant la numérotation.
    • Vidéoconférence.
    • Autres fonctionnalités de sécurité telles que la salle d’attente et l’automatisation de l’admission des participants.
    • Associez une réunion à une conversation Microsoft Teams.

Comparaison des API

Le tableau suivant décrit les différences au niveau de l’API.

Fonctionnalité de réunion en ligne API de calendrier (ressource d’événement) API de communications cloud (ressource onlineMeeting)
Membres de l’API principale ressource d’événement :
- propriété isOnlineMeeting
- propriété isOnlineMeeting du type onlineMeetingInfo
- propriété onlineMeetingProvider
ressource calendrier :
- propriété allowedOnlineMeetingProviders
- propriété defaultOnlineMeetingProvider
 ressource onlineMeeting
ressource audioConferencing
Intégration à un élément de calendrier
- L’API créer ou mettre à jour un événement définit automatiquement l’événement de calendrier Outlook résultant en tant que réunion en ligne.
-Utilisez les propriétés isOnlineMeeting, onlineMeetinget onlineMeetingProvider de l’ événement calendrier Outlook renvoyée.		 - L’API Créer renvoie une ressource onlineMeeting indépendante d’un type de calendrier particulier.
- Ne crée ou ne met pas à jour les événements Outlook.
- Intégrez les informations de ressources onlineMeeting dans une expérience d’application adaptée à votre scénario.
- Utilisez createOrGet pour renvoyer une réunion en ligne ayant une valeur externalId spécifiée, ou en créer une si aucune n’existe déjà, afin de simplifier l’incorporation de la réunion résultante dans un calendrier tiers.
Passage à une réunion en mode hors connexion - Non : une fois que vous activez un événement pour rejoindre en ligne, vous ne pouvez pas le mettre à jour pour en faire une réunion hors connexion.
- Impossible de modifier la propriété onlineMeetingProvider, ni définir isOnlineMeeting sur false pour désactiver la réunion en ligne.		 Non : une fois que vous avez créé une ressource onlineMeeting, vous pouvez la supprimer uniquement, mais pas la modifier en réunion hors connexion.
Informations de jointure basées sur des paramètres régionaux Aucune intégration API directe. - Utilisez l’en-tête HTTP Accept-Language lors de la création d’une réunion en ligne.
- Consultez exemple.
Jointure sur Internet (VoIP) Via la propriété onlineMeeting, accès joinUrl. Utilisez la propriété joinWebUrl.
Jointure par appels entrants Via la propriété onlineMeeting, accès :
- conferenceId, quickDial, phones, tollFreeNumbers, tollNumber.		 Via la propriété audioConferencing, accès :
- conferenceId, tollFreeNumber, tollNumber.
- dialinUrl propriété pour une page web accessible en externe qui contient des informations sur les appels entrants pour faciliter l’intégration aux applications tierces.
Participation à la vidéoconférence (audio et vidéo) Aucune intégration API directe. Utilisez la propriété videoTeleconferenceId.
Salle d’attente et adhésion de participants automatisés à une réunion en ligne - Aucune intégration API directe.
- Dans le blob injecté Participer à la réunion Teams de l'événement, le participant peut cliquer sur un lien Options de réunion pour accéder à la salle d’attente, si l'administrateur l'a activé.		 - L’API différencie les participants de l’entreprise de l’organisateur et des entreprises fédérées, ainsi que les autres participants, y compris les personnes anonymes.
- Utilisez la propriété lobbyBypassSettings .
En relation avec une conversation Teams Aucune intégration API directe. Utilisez la propriété chatInfo.