Comment installer et utiliser Microsoft Graph
Découvrez comment installer et utiliser Microsoft Graph pour accéder facilement aux données des services Microsoft, grâce à une API REST simple et des outils adaptés.
Microsoft Graph est une méthode permettant aux développeurs d'accéder aux données et services du cloud de Microsoft, y compris Microsoft 365, Windows et Enterprise Mobility + Security. Il propose une API REST simple et un ensemble de SDK, vous permettant de travailler avec divers services. Vous pouvez gérer des utilisateurs dans Microsoft Entra ID, manipuler des fichiers dans OneDrive ou interagir avec des canaux dans Microsoft Teams, le tout via une interface facile d'utilisation. Dans cet article, nous allons apprendre comment installer et utiliser Microsoft Graph.
Installer et utiliser Microsoft Graph
Avant l'installation, il est crucial de comprendre que Microsoft Graph est une API web RESTful qui intègre divers services Microsoft. Vous n'avez besoin de vous authentifier qu'une seule fois pour accéder aux données à travers ces services. Une étape clé consiste à configurer l'enregistrement d'application Azure Active Directory (Azure AD), qui sert d'identité dans Azure AD et vous permet d'obtenir des jetons d'authentification pour l'API Graph. Lors de l'enregistrement, vous allez également configurer des autorisations (scopes) pour définir les données auxquelles votre application peut accéder.
Pour utiliser Microsoft Graph sur Windows 11, suivez les étapes ci-dessous.
- Installez Microsoft Graph
- Choisissez votre API
- Authentifiez-vous et connectez-vous
- Faites votre premier appel API
Parlons-en en détail.
Installer Microsoft Graph
Le SDK est publié sur PowerShell Gallery. La méthode recommandée est d'utiliser la cmdlet Install-Module.
Tout d'abord, lancez PowerShell en tant qu'administrateur.
En exécutant la commande suivante, nous allons définir la stratégie d'exécution. Sur les systèmes Windows, vous devrez peut-être définir la politique d'exécution des scripts pour autoriser l'installation de modules :
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Exécutez la commande suivante pour installer le SDK pour l'utilisateur actuel.
Install-Module Microsoft.Graph -Scope CurrentUser -Repository PSGallery -Force
Pour expérimenter également les fonctionnalités en préversion, vous pouvez installer le module beta séparément.
Install-Module Microsoft.Graph.Beta -Scope CurrentUser
Remarque : Le SDK comprend plus de 47 sous-modules. Installer le module principal Microsoft.Graph les installe tous. Pour une installation plus légère, vous pouvez installer uniquement les modules de service spécifiques dont vous avez besoin, mais incluez toujours Microsoft.Graph.Authentication.
Choisir votre API
Lorsque vous travaillez avec le SDK Microsoft Graph, vous interagissez principalement avec deux points de terminaison API différents : le point de terminaison stable v1.0 et le point de terminaison beta. Le point de terminaison v1.0 contient des APIs généralement disponibles (GA) qui sont pleinement supportées pour un usage en production. Microsoft applique un contrôle strict des modifications à cette version pour garantir la compatibilité ascendante, ce qui en fait le choix fiable et obligatoire pour toutes les applications et scripts de production.
En revanche, le point de terminaison beta donne accès à des APIs de préversion qui incluent souvent de nouvelles fonctionnalités ou des fonctionnalités à venir. Cette version est idéale pour les tests, le développement et l'exploration précoce des capacités futures. Cependant, étant donné que le point de terminaison beta est sujet à des changements sans préavis, y compris des modifications disruptives potentielles, il ne doit être utilisé que pour l'expérimentation et jamais dans un environnement de production en direct.
Authentifier et se connecter
L'authentification est votre première étape pour effectuer des appels API. Microsoft Graph prend en charge deux modèles d'autorisation principaux.
- Authentification déléguée (Utilisateur) : Votre application agit au nom d'un utilisateur connecté. L'application ne peut accéder qu'aux données auxquelles l'utilisateur lui-même a le droit d'accéder.
- Authentification uniquement de l'application : Votre application accède aux données en son propre nom, sans contexte utilisateur. Cela est courant pour les services en arrière-plan ou les applications de démon.
Pour se connecter en utilisant le SDK PowerShell avec des autorisations déléguées, vous utilisez la cmdlet Connect-MgGraph et spécifiez les scopes de permission requis.
Connect-MgGraph -Scopes "User.Read.All", "Mail.Read"
Cette commande ouvre une fenêtre de navigateur pour que vous puissiez vous connecter et accorder votre consentement aux autorisations spécifiées. Trouver les autorisations correctes (scopes) pour une tâche peut être fait en utilisant des outils tels que Microsoft Graph Explorer ou la cmdlet Find-MgGraphCommand dans PowerShell.
Faire votre premier appel API
Une fois authentifié, vous pouvez commencer à interagir avec les données.
API REST directement. Chaque appel à l'API REST Graph suit un schéma similaire.
{Méthode HTTP} https://graph.microsoft.com/{version}/{ressource}?{paramètres-de-requête}Par exemple, pour obtenir le profil de l'utilisateur connecté en utilisant le point de terminaison stable v1.0, la requête serait.
GET https://graph.microsoft.com/v1.0/me
Vous pouvez même utiliser des Cmdlets du SDK PowerShell.
Get-MgUser -UserId 'me'
Pour effectuer des opérations plus complexes, comme envoyer un e-mail, vous utiliseriez une cmdlet qui correspond à la méthode POST.
Voilà !
Quelles sont les principales différences entre Microsoft Graph v1.0 et les API bêta ?
La principale différence est la stabilité par rapport à l'accès anticipé. L'API v1.0 offre des fonctionnalités fiables et prêtes pour la production avec un cycle de vie clair. En revanche, l'API bêta présente de nouvelles fonctionnalités qui sont encore en développement. Avec la bêta, vous pouvez essayer les dernières capacités, mais ces fonctionnalités peuvent changer ou être supprimées sans avertissement puisqu'elles n'ont pas les mêmes garanties de compatibilité que la version v1.0.
Puis-je tester de nouvelles fonctionnalités Microsoft Graph avant leur sortie ?
Oui, vous pouvez tester les fonctionnalités à venir en utilisant le point de terminaison bêta de Microsoft Graph dans un environnement de développement ou de test dédié. Cela permet aux développeurs d'explorer de nouvelles API, de fournir des retours à Microsoft et de se préparer pour de futures intégrations. Il est essentiel d'utiliser le point de terminaison bêta uniquement à des fins non productives, telles que des projets de preuve de concept ou des tests en bac à sable, et de planifier la migration de votre code vers le point de terminaison stable v1.0 une fois que les caractéristiques deviennent généralement accessibles.
Maintenant que tu as fini de lire Comment installer et utiliser Microsoft Graph, nous t'invitons à explorer davantage la catégorie Tutoriels. Tu y trouveras d'autres articles intéressants qui élargiront tes connaissances et te tiendront informé. Ne cesse pas de lire et de découvrir plus!