Choisir une API dans Microsoft Graph pour créer et participer à des réunions en ligneChoose an API in Microsoft Graph to create and join online meetings

Microsoft Graph propose deux ensembles d'API qui permettent d'organiser et de participer à des réunions en ligne sur Microsoft Teams ou Skype :Microsoft Graph offers two API sets that arrange and join online meetings on Microsoft Teams or Skype:

Le choix se situe entre :The choice is between:

  • 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.A convenient programmatic way to set up an online meeting in the Outlook calendar where attendees click to join the meeting, and continue their experience in Teams or Skype.
  • Et une intégration programmatique plus complète des équipes ou fonctionnalités Skype dans une application pour une expérience plus personnalisée.And, a richer programmatic integration of Teams or Skype features in an app for a more customized experience.

Éléments à prendre en considération lors du choix d’une API pour votre scénarioConsiderations when choosing an API for your scenario

Sélectionnez l’API calendrier pour une intégration simplifiée et intégrée dans le calendrier Outlook, qui génère un événement de réunion en ligne dans le calendrier Outlook :Choose the calendar API for a streamlined, built-in integration with Outlook calendar, that results in an online meeting event in the Outlook calendar:

  • Support programmatique :Programmatic support:
    • 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.Apps can directly create or update an event as an online meeting in the Outlook calendar, with a join-Teams-meeting blob inserted in the Outlook calendar event.
    • Les applications bénéficient de propriétés pour participer à une réunion sur Internet ou en utilisant la numérotation.Apps get properties for joining meeting over the Internet or by dialing in.
  • 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 :Attendees' UI experience with the programmatically created calendar event is in full parity with any event that has been created through the Outlook UI:
    • Les participants peuvent choisir de se réunir en ligne ou en personne.Attendees can choose to meet online or in person.
    • 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.Attendees can click in the join-Teams-meeting blob to join meeting over the Internet or by dialing in.
    • 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.Attendees can use other rich features of Teams, including video conferencing and meeting lobby, if configured.

Remarque : l’intégration du calendrier Outlook part du principe qu’un administrateur a configuré Outlook pour les réunions en ligne.Note: Integration with Outlook calendar assumes an administrator has set up Outlook for online meetings. Vérifiez le support avant d’utiliser l’API.Verify the support before using the API.

Choisissez l’API de communications cloud pour la flexibilité et la prise en charge d’un programme plus large :Choose the cloud communications API for flexibility and broader programmatic support:

  • Les applications offrent davantage de flexibilité pour intégrer les résultats de l’API aux activités sectorielles et d’autres applications.Apps have more flexibility to further integrate the API results with line of business and other apps. L’API est dissociée d’un calendrier spécifique et ne crée pas d’événement dans un calendrier.The API is decoupled with any specific calendar, and does not create an event in any calendar.
  • Les applications peuvent offrir les fonctionnalités suivantes aux participants :Apps can provide the following capabilities for attendees:
    • Informations de jointure basées sur des paramètres régionaux.Locale-based join information.
    • Participer à une réunion sur Internet ou en utilisant la numérotation.Joining meeting over the Internet or by dialing in.
    • Vidéoconférence.Video-conferencing.
    • Autres fonctionnalités de sécurité telles que la salle d’attente et l’automatisation de l’admission des participants.Additional security features such as meeting lobby and automating attendee admission (preview).
    • Associez une réunion à une conversation Microsoft Teams.Associating meeting with a Microsoft Teams chat.

Comparaison des APIComparing the APIs

Le tableau suivant décrit les différences au niveau de l’API.The following table details the differences at the API level.

Fonctionnalité de réunion en ligneOnline meeting feature API de calendrier (ressource d’événement)Calendar API (event resource) API de communication cloud (ressource onlineMeeting)Cloud communication API (onlineMeeting resource)
Membres de l’API principaleMain API members ressource d’événement :event resource:
- propriété isOnlineMeeting- isOnlineMeeting property
- propriété isOnlineMeeting du type onlineMeetingInfo- onlineMeeting property of the onlineMeetingInfo type
- propriété onlineMeetingProvider- onlineMeetingProvider property
ressource calendrier :calendar resource:
- propriété allowedOnlineMeetingProviders- allowedOnlineMeetingProviders property
- propriété defaultOnlineMeetingProvider- defaultOnlineMeetingProvider property
ressource onlineMeetingonlineMeeting resource
ressource audioConferencingaudioConferencing resource
Intégration à un élément de calendrierIntegration with a calendar item
- Créer ou mettre à jour l’API événement définit automatiquement l’événement de calendrier Outlook résultante en tant que réunion en ligne.- Create or update event API automatically sets the resultant Outlook calendar event as an online meeting.
-Utilisez les propriétés isOnlineMeeting, onlineMeetinget onlineMeetingProvider de l’ événement calendrier Outlook renvoyée.- Use the isOnlineMeeting, onlineMeeting, and onlineMeetingProvider properties of the returned Outlook calendar event.
- L’API Créer renvoie une ressource onlineMeeting indépendante d’un type de calendrier particulier.- Create API returns an onlineMeeting resource that is independent of a particular calendar type.
- Ne crée ou ne met pas à jour les événements Outlook.- Does not create or update any Outlook event.
- Intégrez les informations de ressources onlineMeeting dans une expérience d’application adaptée à votre scénario.- Integrate the returned onlineMeeting resource information in an app experience appropriate for your scenario.
- 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.- Use createOrGet to return an online meeting that has a specified externalId value, or create one if none already exists, to streamline embedding the resultant meeting in a third-party calendar.
Passage à une réunion en mode hors connexionChanging to offline meeting - 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.- No - once you enable an event for joining online, you cannot update it to make it an offline meeting.
- Impossible de modifier la propriété onlineMeetingProvider, ni définir isOnlineMeeting sur false pour désactiver la réunion en ligne.- Cannot change the onlineMeetingProvider property, nor set isOnlineMeeting to false to disable the meeting online.
Non : une fois que vous avez créé une ressource onlineMeeting, vous pouvez la supprimer uniquement, mais pas la modifier en réunion hors connexion.No - once you create an onlineMeeting resource, you can only delete it but cannot change it to an offline meeting.
Informations de jointure basées sur des paramètres régionauxLocale-based join information Aucune intégration API directe.No direct API integration. - Utilisez l’en-tête HTTP Accept-Language lors de la création d’une réunion en ligne.- Use the Accept-Language HTTP header when creating an online meeting.
- Consultez exemple.- See example.
Jointure sur Internet (VoIP)Joining over Internet (VoIP) Via la propriété onlineMeeting, accès joinUrl.Through the onlineMeeting property, access joinUrl. Utilisez la propriété joinWebUrl.Use the joinWebUrl property.
Jointure par appels entrantsJoining by dial-in Via la propriété onlineMeeting, accès :Through the onlineMeeting property, access:
- conferenceId, quickDial, phones, tollFreeNumbers, tollNumber.- conferenceId, quickDial, phones, tollFreeNumbers, tollNumber.
Via la propriété audioConferencing, accès :Through the audioConferencing property, access:
- conferenceId, tollFreeNumber, tollNumber.- 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.- dialinUrl property for an externally-accessible web page that contains dial-in info to facilitate integration with third-party apps.
Participation à la vidéoconférence (audio et vidéo)Joining by video conferencing (audio and video) Aucune intégration API directe.No direct API integration. Utilisez la propriété videoTeleconferenceId.Use the videoTeleconferenceId property.
Salle d’attente et adhésion de participants automatisés à une réunion en ligneMeeting lobby and automating attendee admission into online meeting - Aucune intégration API directe.- No direct API integration.
- 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é.- In the injected join-Teams-meeting blob of the event, attendee can click a Meeting options link to access meeting lobby, if enabled by the administrator.
- 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.- API differentiates attendees from the organizer’s company and federated companies, and other attendees including anonymous ones.
- Utilisez la propriété autoAdmittedUsers (aperçu).- Use the autoAdmittedUsers property (preview).
En relation avec une conversation TeamsRelating to a Teams chat Aucune intégration API directe.No direct API integration. Utilisez la propriété chatInfo.Use the chatInfo property.

Voir aussiSee also