Migration de Live SDK vers Microsoft Graph
Si vous utilisez les API Live SDK ou Live Connect pour vous connecter à un profil, calendrier, à des contacts ou des fichiers, votre application doit être mise à jour pour gérer les fonctionnalités.
Les API Live SDK et Live Connect ont été marquées comme déconseillées pendant plus d’un an. Comme annoncé sur le blog des développeurs Office, ces API sont désormais en fin de vie et ne seront plus disponibles après le 1er novembre 2018.
Les données de profil et de contacts ne seront plus disponibles dans les API Live Connect à compter du 1er décembre 2017. Les données de calendrier ne sont plus disponibles dans Live Connect depuis juin 2017.
Les API Live Connect sont toutes hébergées dans https://apis.live.net/v5.0. Ce préfixe doit être utilisé dans tous les exemples ci-dessous.
Passage à Microsoft Graph
Les fonctionnalités disponibles précédemment via les API Live SDK et Live Connect sont disponibles via Microsoft Graph. Pour continuer à intégrer les services Microsoft, les développeurs doivent mettre à jour leurs applications afin d’utiliser Microsoft Graph avant l’chronologie de ces services.
Comme pour les fonctionnalités de Live Connect, Microsoft Graph a un certain nombre de ressources disponibles en fonction du type de données utilisateur avec lequel votre application interagit :
- Authentification de compte Microsoft
- Fichiers OneDrive
- Calendrier Outlook
- Messages Outlook
- Contacts personnels
- API d’identité et de profil
Bibliothèques
Microsoft Graph propose des bibliothèques client pour de nombreuses plateformes pouvant s’intégrer avec votre application comme Live SDK.
Autorisations
Microsoft Graph utilise un ensemble d’étendues d’autorisation différent de Live Connect. Pour accéder aux API de Microsoft Graph, votre application devra changer d’étendues d’autorisation. Pour cela, votre application doit inviter l’utilisateur à donner son consentement pour la connexion et les nouvelles autorisations.
Voir la Référence des autorisations de Microsoft Graph pour plus de détails.
| Étendue de Live Connect | Autorisation de Microsoft Graph | Description |
|---|---|---|
wl.basic |
Contacts.Read |
Permet à l’application de lire les contacts de l’utilisateur. |
wl.offline_access |
offline_access |
Permet à l’application de lire et de mettre à jour les données de l’utilisateur, même si elles n’utilisent pas l’application actuellement. |
wl.signin |
openid |
Permet aux utilisateurs de se connecter à l’application avec leurs comptes professionnels ou scolaires et permet à l’application d’afficher les informations de profil utilisateur de base. |
wl.skydrive |
Files.Read |
Permet à l’application de lire les fichiers de l’utilisateur connecté. |
wl.skydrive_update |
Files.ReadWrite |
Permet à l’application de lire, créer, mettre à jour et supprimer tous les fichiers de l’utilisateur connecté. |
wl.contacts_create |
Contacts.ReadWrite |
Permet à l’application de créer, lire, mettre à jour et supprimer des contacts de l’utilisateur. |
wl.contacts_calendar |
Calendars.Read.Shared |
Permet à l’application de lire les contacts auxquels l’utilisateur peut accéder, notamment les contacts utilisateur et les contacts partagés. |
wl.contacts_photos |
Contacts.Read |
Permet à l’application de lire les contacts de l’utilisateur. |
wl.contacts_skydrive |
Files.ReadWrite.All |
Permet à l’application de lire, créer, mettre à jour et supprimer tous les fichiers auxquels l’utilisateur connecté peut accéder. |
wl.calendars |
Calendars.Read |
Permet à l’application de lire les événements dans les calendriers utilisateur. |
wl.calendars_update |
Calendars.ReadWrite |
Permet à l’application de créer, lire, mettre à jour et supprimer des événements dans des calendriers utilisateur. |
wl.emails |
Mail.Read |
Permet à l’application de lire les courriers électroniques dans des boîtes aux lettres utilisateur. |
wl.events_create |
Calendars.ReadWrite |
Permet à l’application de créer, lire, mettre à jour et supprimer des événements dans des calendriers utilisateur. |
wl.photos |
Files.Read |
Permet à l’application de lire les fichiers de l’utilisateur connecté, y compris les photos. |
office.onenote_create |
Notes.ReadWrite |
Permet à l’application de lire, partager et modifier des blocs-notes OneNote au nom de l’utilisateur connecté. |
Identificateurs uniques
Microsoft Graph utilise un modèle différent pour les identificateurs uniques de Live Connect ou Live SDK. Vous ne pouvez pas utiliser les identificateurs de Live Connect avec Microsoft Graph.
Votre application devra redécouvrir les identificateurs des éléments connus à l’aide de la recherche, navigation basée sur le chemin d’accès, ou en demandant à l’utilisateur de sélectionner les éléments à nouveau.
API d’identité
La fonctionnalité de l’API d’identité ne renverra plus de données utilisateur à compter du 1er décembre 2017.
Le tableau suivant présente les méthodes dans l’API Live Connect et la méthode équivalente dans Microsoft Graph. Le format du chemin REST peut être identique mais les données de réponse ne suivent pas le même format. Vous devez utiliser le Kit de développement logiciel (SDK) Microsoft Graph ou mettre à jour votre mappage JSON pour utiliser le format de ressource Microsoft Graph.
| API Live Connect | API Microsoft Graph | Remarques |
|---|---|---|
GET /me |
GET /me |
Essayez-les. Renvoie le profil utilisateur, le nom d’affichage et d’autres informations. |
GET /me/picture |
GET /me/photo/$value |
Essayez-les. Renvoie la photo de profil de l’utilisateur. |
API de contacts
La fonctionnalité de l’API de contacts ne renverra plus de données utilisateur à compter du 1er décembre 2017.
Le tableau suivant présente les méthodes dans l’API Live Connect et la méthode équivalente dans Microsoft Graph. Le format du chemin REST peut être identique mais les données de réponse ne suivent pas le même format. Vous devez utiliser le Kit de développement logiciel (SDK) Microsoft Graph ou mettre à jour votre mappage JSON pour utiliser le format de ressource Microsoft Graph.
| API Live Connect | API Microsoft Graph | Remarques |
|---|---|---|
GET /me/contacts |
GET /me/contacts |
Essayez-les. Renvoie une liste des contacts personnels de l’utilisateur. |
GET /{contact-id} |
GET /me/contacts/{contact-id} |
Essayez-les. Renvoie les données pour un contact spécifié. |
POST /{contact-id} |
POST /me/contacts |
Créez un contact. |
API de calendrier
L’API de calendrier ne renvoie plus de données utilisateur à compter de juin 2017.
Le tableau suivant présente les méthodes dans l’API Live Connect et la méthode équivalente dans Microsoft Graph. Le format du chemin REST peut être identique mais les données de réponse ne suivent pas le même format. Vous devez utiliser le Kit de développement logiciel (SDK) Microsoft Graph ou mettre à jour votre mappage JSON pour utiliser le format de ressource Microsoft Graph.
| API Live Connect | API Microsoft Graph | Remarques |
|---|---|---|
GET /me/calendars |
GET /me/calendars |
Essayez Renvoie une liste des calendriers de l’utilisateur. |
GET /{calendar-id} |
GET /me/events |
Essayez Renvoie des événements des calendriers de l’utilisateur. |
POST /{calendar-id} |
POST /me/events |
Créez un événement sur le calendrier de l’utilisateur. |
API REST OneDrive
La partie OneDrive de l’API Live Connect ne sera plus fonctionnelle à compter du 1er novembre 2018.
Les tableaux suivants décrivent les méthodes dans l’API Live Connect et les méthodes équivalentes dans Microsoft Graph.
Le format du chemin REST peut être identique mais les données de réponse ne suivent pas le même format. Vous devez utiliser le Kit de développement logiciel (SDK) Microsoft Graph ou mettre à jour votre mappage JSON pour utiliser le format de ressource Microsoft Graph.
Pour plus d’informations sur la navigation dans le contenu OneDrive d’un utilisateur reportez-vous à l’article Obtenir une ressource DriveItem.
| API Live Connect | API Microsoft Graph | Remarques |
|---|---|---|
GET /folder.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!110 |
GET /me/drive/items/A6B2A7E8F2515E5E!110 |
Essayez-les. Obtenez les métadonnées pour un dossier. |
GET /me/skydrive/camera_roll |
GET /me/drive/special/cameraroll |
Récupérez le dossier de sauvegarde de la pellicule de l’utilisateur. |
GET /me/skydrive/files |
GET /me/drive/root/children |
Essayez-les. Répertoriez le contenu du dossier racine OneDrive. |
GET /me/skydrive/my_documents |
GET /me/drive/special/documents |
Récupérez le dossier de documents de l’utilisateur. |
GET /me/skydrive/my_photos |
GET /me/drive/special/photos |
Récupérez le dossier de photos de l’utilisateur. |
GET /me/skydrive/public_documents |
s/o | Récupérez le dossier partagé public de l’utilisateur. Ce concept a été supprimé de OneDrive et n’est pas disponible dans Microsoft Graph. |
GET /me/skydrive/quota |
GET /me/drive?$select=quota |
Essayez-les. Renvoie les informations de quota du lecteur OneDrive d’un utilisateur, y compris l’espace utilisé et l’espace restant. |
GET /me/skydrive/recent |
GET /me/drive/recent |
Renvoyez une liste de fichiers et dossiers partagés avec l’utilisateur actuel. |
GET /me/skydrive/shared |
GET /me/drive/sharedWithMe |
Renvoyez une liste de fichiers et dossiers partagés avec l’utilisateur actuel. |
GET /me/skydrive |
GET /me/drive/root |
Essayez-les. Récupérez le dossier racine dans le lecteur OneDrive de l’utilisateur. |
GET /skydrive/get_item_preview |
GET /me/drive/items/{item-id}/thumbnails |
Renvoie les miniatures disponibles pour un fichier ou un dossier dans OneDrive. |
Sélecteur de fichiers pour les applications web
La fonctionnalité de sélecteur de fichiers OneDrive qui était fournie dans le cadre du Kit de développement logiciel (SDK) Live est désormais disponible via le Sélecteur de fichiers OneDrive.
La Version 5 du Kit de développement logiciel (SDK) Live (sélecteur de fichiers OneDrive) ne sera plus fonctionnelle à compter du 1er novembre 2018.
Ressources supplémentaires
Pour plus d’informations sur l’utilisation de Microsoft Graph, essayez le Démarrage rapide de Microsoft Graph.