Migrieren von Live SDK zu Microsoft Graph
Wenn Sie Live SDK- oder Live Connect-APIs für die Verbindung zu Profil, Kalender, Kontakten oder Dateien verwenden, muss Ihre App aktualisiert werden, um die Funktionalität beizubehalten.
Live SDK- und Live Connect-APIs sind seit mehr als einem Jahr als veraltet markiert. Wie im Office-Entwickler-Blog angekündigt, endet der Lebenszyklus dieser APIs nun, und sie sind nach dem 1. November 2018 nicht mehr verfügbar.
Profil- und Kontaktdaten sind ab dem 1. Dezember 2017 nicht mehr über die Live Connect-APIs verfügbar. Kalenderdaten sind seit Juni 2017 nicht mehr über Live Connect verfügbar.
Die Live Connect-APIs werden alle über https://apis.live.net/v5.0 gehostet. Dies sollte in allen Beispielen unten vorausgesetzt werden.
Wechseln zu Microsoft Graph
Die Funktionen, die zuvor über die Live SDK- und Live Connect-APIs verfügbar waren, sind über Microsoft Graph verfügbar. Um weiterhin in Microsoft-Dienste zu integrieren, müssen Entwickler ihre Apps aktualisieren, um Microsoft Graph zu verwenden, bevor die Zeitleiste für diese Dienste eingestellt werden.
Ähnlich wie Live Connect weist Microsoft Graph eine Reihe verfügbarer Ressourcen auf, die abhängig von Typ der Benutzerdaten verfügbar sind, mit denen Ihre App interagiert:
- Microsoft-Konto-Authentifizierung
- OneDrive-Dateien
- Outlook-Kalender
- Outlook-Nachrichten
- Private Kontakte
- Profil- und Identitäts-API
Bibliotheken
Microsoft Graph bietet Client-Bibliotheken für viele Plattformen, die mit Ihrer Anwendung ähnlich wie bei Live SDK integriert werden können.
Berechtigungen
Microsoft Graph verwendet einen anderen Satz von Berechtigungsumfängen als Live Connect. Für den Zugriff auf die Microsoft Graph-APIs muss Ihre App die Berechtigungsumfänge umstellen. Dies erfordert, dass Ihre App den Benutzer nach seiner Zustimmung zur Anmeldung und den neuen Berechtigungen fragt.
Unter Microsoft Graph-Berechtigungsreferenz finden Sie alle Informationen.
| Live Connect-Umfang | Microsoft Graph-Berechtigung | Beschreibung |
|---|---|---|
wl.basic |
Contacts.Read |
Ermöglicht der App, Benutzerkontakte zu lesen. |
wl.offline_access |
offline_access |
Ermöglicht der App, Benutzerdaten zu lesen und zu aktualisieren, auch wenn diese die App derzeit nicht verwenden. |
wl.signin |
openid |
Damit können Benutzer sich mit Ihren Geschäfts- oder Schulkonten bei der App anmelden, und die App kann grundlegende Benutzerprofilinformationen lesen. |
wl.skydrive |
Files.Read |
Ermöglicht der App, die Dateien des angemeldeten Benutzers zu lesen. |
wl.skydrive_update |
Files.ReadWrite |
Ermöglicht der App, Dateien des angemeldeten Benutzers zu lesen, zu erstellen, zu aktualisieren und zu löschen. |
wl.contacts_create |
Contacts.ReadWrite |
Ermöglicht der App, Benutzerkontakte zu erstellen, zu lesen, zu aktualisieren und zu löschen. |
wl.contacts_calendar |
Calendars.Read.Shared |
Ermöglicht der App, Kontakte zu lesen, für die der Benutzer über Zugriffsberechtigungen verfügt, einschließlich der eigenen Kontakte des Benutzers und freigegebener Kontakte. |
wl.contacts_photos |
Contacts.Read |
Ermöglicht der App, Benutzerkontakte zu lesen. |
wl.contacts_skydrive |
Files.ReadWrite.All |
Ermöglicht der App, alle Dateien zu lesen, zu erstellen, zu aktualisieren und zu löschen, auf die der angemeldete Benutzer zugreifen kann. |
wl.calendars |
Calendars.Read |
Ermöglicht der App, Ereignisse in Benutzerkalendern zu lesen. |
wl.calendars_update |
Calendars.ReadWrite |
Ermöglicht der App, Ereignisse in Benutzerkalendern zu erstellen, zu lesen, zu aktualisieren und zu löschen. |
wl.emails |
Mail.Read |
Die App kann E-Mails in Benutzerpostfächern lesen. |
wl.events_create |
Calendars.ReadWrite |
Ermöglicht der App, Ereignisse in Benutzerkalendern zu erstellen, zu lesen, zu aktualisieren und zu löschen. |
wl.photos |
Files.Read |
Ermöglicht der App, die Dateien des angemeldeten Benutzers zu lesen, einschließlich Fotos. |
office.onenote_create |
Notes.ReadWrite |
Ermöglicht der App, OneNote-Notizbücher im Namen des angemeldeten Benutzers zu lesen, freizugeben und zu ändern. |
Eindeutige Bezeichner
Microsoft Graph verwendet ein anderes Farbschema für eindeutige Bezeichner als Live Connect oder Live SDK. Sie können die Bezeichner aus Live Connect nicht mit Microsoft Graph verwenden.
Ihre Anwendung muss die Bezeichner für bekannte Elemente über die Suche, pfadbasierte Navigation oder erneute Auswahl der Elemente durch den Benutzer erneut ermitteln.
Identitäts-API
Die Identitäts-API-Funktionen geben ab dem 1. Dezember 2017 keine Benutzerdaten mehr zurück.
In der folgenden Tabelle werden die Methoden in der Live Connect-API und die äquivalente Methode in Microsoft Graph erläutert. Das Format des REST-Pfads ist evtl. ähnlich, die Antwortdaten weisen jedoch nicht dasselbe Format auf. Sie müssen das Microsoft Graph-SDK verwenden oder Ihre JSON-Zuordnung aktualisieren, um das Microsoft Graph-Ressourcenformat zu verwenden.
| Live Connect-API | Microsoft Graph-API | Notizen |
|---|---|---|
GET /me |
GET /me |
Probieren Sie es aus. Gibt Benutzerprofil, Anzeigename und zusätzliche Informationen an. |
GET /me/picture |
GET /me/photo/$value |
Probieren Sie es aus. Gibt das Profilfoto des Benutzers zurück. |
Kontakt-API
Die Kontakt-API-Funktionen geben ab dem 1. Dezember 2017 keine Benutzerdaten mehr zurück.
In der folgenden Tabelle werden die Methoden in der Live Connect-API und die äquivalente Methode in Microsoft Graph erläutert. Das Format des REST-Pfads ist evtl. ähnlich, die Antwortdaten weisen jedoch nicht dasselbe Format auf. Sie müssen das Microsoft Graph-SDK verwenden oder Ihre JSON-Zuordnung aktualisieren, um das Microsoft Graph-Ressourcenformat zu verwenden.
| Live Connect-API | Microsoft Graph-API | Notizen |
|---|---|---|
GET /me/contacts |
GET /me/contacts |
Probieren Sie es aus. Gibt eine Liste mit den persönlichen Kontakten des Benutzers zurück. |
GET /{contact-id} |
GET /me/contacts/{contact-id} |
Probieren Sie es aus. Gibt die Daten für einen angegebenen Kontakt zurück. |
POST /{contact-id} |
POST /me/contacts |
Erstellen Sie einen neuen Kontakt. |
Kalender-API
Der Kalender-API gibt ab Juni 2017 keine Benutzerdaten mehr zurück.
In der folgenden Tabelle werden die Methoden in der Live Connect-API und die äquivalente Methode in Microsoft Graph erläutert. Das Format des REST-Pfads ist evtl. ähnlich, die Antwortdaten weisen jedoch nicht dasselbe Format auf. Sie müssen das Microsoft Graph-SDK verwenden oder Ihre JSON-Zuordnung aktualisieren, um das Microsoft Graph-Ressourcenformat zu verwenden.
| Live Connect-API | Microsoft Graph-API | Notizen |
|---|---|---|
GET /me/calendars |
GET /me/calendars |
Testen Gibt eine Liste der Kalender des Benutzers zurück. |
GET /{calendar-id} |
GET /me/events |
Testen Gibt Ereignisse aus den Kalendern des Benutzers zurück. |
POST /{calendar-id} |
POST /me/events |
Erstellen Sie ein neues Ereignis im Kalender des Benutzers. |
OneDrive-REST-API
Der OneDrive-Teil der Live Connect-API funktioniert ab dem 1. November 2018 nicht mehr.
In den folgenden Tabellen werden die Methoden in der Live Connect-API und die äquivalenten Methoden in Microsoft Graph erläutert.
Das Format des REST-Pfads ist evtl. ähnlich, die Antwortdaten weisen jedoch nicht dasselbe Format auf. Sie müssen das Microsoft Graph-SDK verwenden oder Ihre JSON-Zuordnung aktualisieren, um das Microsoft Graph-Ressourcenformat zu verwenden.
Umfassende Informationen zum Navigieren durch die Inhalte eines Benutzer-OneDrive finden Sie unter Abrufen einer DriveItem-Ressource.
| Live Connect-API | Microsoft Graph-API | Notizen |
|---|---|---|
GET /folder.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!110 |
GET /me/drive/items/A6B2A7E8F2515E5E!110 |
Probieren Sie es aus. Rufen Sie die Metadaten für einen Ordner ab. |
GET /me/skydrive/camera_roll |
GET /me/drive/special/cameraroll |
Rufen Sie den Sicherungsordner mit den eigenen Aufnahmen des Benutzers ab. |
GET /me/skydrive/files |
GET /me/drive/root/children |
Probieren Sie es aus. Listen Sie die Inhalte eines OneDrive-Stammordners auf. |
GET /me/skydrive/my_documents |
GET /me/drive/special/documents |
Rufen Sie den Dokumentordner des Benutzers ab. |
GET /me/skydrive/my_photos |
GET /me/drive/special/photos |
Rufen Sie den Fotoordner des Benutzers ab. |
GET /me/skydrive/public_documents |
N/V | Rufen Sie den öffentlichen freigegebenen Ordner des Benutzers ab. Dieses Konzept wurde aus OneDrive entfernt und ist nicht in Microsoft Graph verfügbar. |
GET /me/skydrive/quota |
GET /me/drive?$select=quota |
Probieren Sie es aus. Gibt die Kontingentinformationen für ein Benutzer-OneDrive zurück, einschließlich verwendeter und verbleibender Speicherplatz. |
GET /me/skydrive/recent |
GET /me/drive/recent |
Gibt eine Liste der Dateien und Ordner zurück, die für den aktuellen Benutzer freigegeben sind. |
GET /me/skydrive/shared |
GET /me/drive/sharedWithMe |
Gibt eine Liste der Dateien und Ordner zurück, die für den aktuellen Benutzer freigegeben sind. |
GET /me/skydrive |
GET /me/drive/root |
Probieren Sie es aus. Rufen Sie den Stammordner im Benutzer-OneDrive ab. |
GET /skydrive/get_item_preview |
GET /me/drive/items/{item-id}/thumbnails |
Gibt die verfügbaren Miniaturansichten für eine Datei oder einen Ordner in OneDrive zurück. |
Dateiauswahl für Web-Apps
Die Dateiauswahlfunktion in OneDrive, die im Rahmen von Live SDK bereitgestellt wurde, ist nun über die OneDrive-Dateiauswahl verfügbar.
Version 5 von Live SDK (OneDrive-Dateiauswahl) ist nach dem 1. November 2018 nicht mehr verfügbar.
Zusätzliche Ressourcen
Weitere Informationen zur Verwendung von Microsoft Graph finden Sie in der Microsoft Graph Quick Start.