Référence version 1.0 de l’API REST Microsoft Graph

Bienvenue dans la référence de l’API REST Microsoft Graph pour le point de terminaison version 1.0.

Les API définis sur le point de terminaison v1.0 (https://graph.microsoft.com/v1.0) sont en statut de disponibilité générale (DG), faisant l'objet d'un processus rigoureux de révision et de rétroaction avec les clients afin de répondre aux besoins de production pratiques. Les mises à jour des API sur ce point de terminaison sont de nature additive et ne violent pas les scénarios d'application existants.

Cas d’utilisation courants

La puissance de Microsoft Graph réside dans la facilité de navigation des entités et des relations entre différents services exposés sur un seul point de terminaison REST Microsoft Graph.

Un certain nombre de ces services sont conçus pour permettre des scénarios riches autour d'un utilisateur et autour d'un groupe.

Cas d’utilisation axés sur les utilisateurs dans la version 1.0

  1. Obtenir le profil et la photo d’un utilisateur, Lisa.
  2. Obtenir les informations de profil concernant le gestionnaire de Lisa et ID de ses rapports directs, tous stockés dans Azure Active Directory.
  3. Accéder aux fichiers de Lisa sur OneDrive Entreprise, rechercher l’identité de la dernière personne qui a modifié un fichier ici et accéder au profil de cette personne.
  4. Accéder au calendrier de Lisa sur Exchange Online et déterminer le meilleur moment pour rencontrer Lisa et son équipe au cours des deux prochaines semaines.
  5. S’abonner à et suivre les modifications du calendrier de Lisa, dire à Lisa quand elle passe plus de 80% de son temps dans des réunions.
  6. Définir les réponses automatiques lorsque Lisa n’est pas au bureau.
  7. Trouver les personnes les plus pertinentes pour Lisa, basées sur la communication, la collaboration et les relations d'affaires.
  8. Obtenir la dernière prévision de ventes à partir d’un graphique dans un fichier Excel de Lisa dans OneDrive Entreprise.
  9. Rechercher les tâches affectées à Lisa dans le planificateur.

Cas d’utilisation de groupe Microsoft 365 dans la version 1.0

  1. Exécuter un rapport sur les groupes Microsoft 365 dans une organisation et identifier le groupe avec le plus de communication parmi les membres du groupe.
  2. Rechercher les offres de ce groupe Microsoft 365et l’affectation de tâches dans cette offre.
  3. Démarrer une nouvelle conversation dans le groupe Microsoft 365 pour déterminer si les membres veulent créer un autre groupe pour partager la charge de travail.
  4. Obtenir le bloc-notes par défaut du groupe et créer une page pour noter le résultat de l’enquête.

Autres versions d’API

Il existe actuellement 2 versions des API REST de Microsoft Graph : la version 1.0 et la version bêta. Si vous êtes intéressé par les API nouvelles ou améliorées qui sont toujours dans l'état d'aperçu, voir la Référence du point de terminaison bêta de Microsoft Graph. Sachez que les API en état d’aperçu sont susceptibles d'être modifiées et peuvent interrompre les scénarios existants sans préavis. Ne reposez pas la production sur des API dans le point de terminaison bêta.

Découvrez plus d’informations sur le contrôle de version et la prise en charge.

Appeler le point de terminaison v1.0

Les demandes de l’API Microsoft Graph au point de terminaison v1.0 utilisent le modèle suivant :

https://graph.microsoft.com/v1.0/{resource}?[query_parameters]

Pour plus d’informations, consultez Utiliser l’API Microsoft Graph.

Nouveautés

Pour en savoir plus sur le les dernières nouveautés et mises à jour dans le point de terminaison version 1.0.

Contactez-nous.

Y a-t-il d’autres API ou fonctionnalités que vous voulez voir dans Microsoft Graph ? Publiez de nouvelles demandes de fonctionnalités sur le forum d'idées de la plateforme Microsoft 365 Développeur.

Vous avez des commentaires sur les API Microsoft Graph existantes ? Suivez-nous sur Github.