Arbeiten mit SharePoint-Websites in Microsoft Graph
Die SharePoint-API in Microsoft Graph unterstützt die folgenden wesentlichen Szenarios:
- Zugriff auf SharePoint-Websites, -Listen und -Laufwerke (Dokumentbibliotheken)
- Schreibgeschützte Unterstützung für Website-Ressourcen (keine Möglichkeit zum Erstellen neuer Websites)
- Lese-/ Schreibzugriff-Unterstützung für -Listen, listItems und driveItems
- Adressierung von Ressourcen nach SharePoint-ID, URL oder relativem Pfad
Die SharePoint-API macht drei wichtige Ressourcentypen verfügbar:
Es folgt ein Beispiel für eine listItem-Ressource:
{
"fields": {
"Title": "Access card",
"Employee": "Ryan Gregg",
"EmployeeId": "10",
"CardSerial": "01235492",
"Alias": "RGregg",
"ID": 1,
"ContentType": "Item",
"Modified": "2016-09-19T23:15:25-07:00",
"Created": "2016-09-19T23:15:25-07:00"
},
"createdBy": {
"user": {
"id": "b757fdcb-0271-4807-b243-504139e4ba04",
"displayName": "Ryan Gregg"
}
},
"createdDateTime": "2016-09-20T06:15:25Z",
"eTag": "48e941c3-9515-4c48-9760-c07c90c79d48,1",
"id": "4",
"lastModifiedBy": {
"user": {
"id": "b757fdcb-0271-4807-b243-504139e4ba04",
"displayName": "Ryan Gregg"
}
},
"lastModifiedDateTime": "2016-09-20T06:15:25Z",
}
Ressourcen legen Daten auf drei verschiedene Arten offen:
- Eigenschaften (wie id und name) legen einfache Werte offen.
- Facets (wie fields und createdBy) legen komplexe Werte offen.
- References (wie items) verweisen auf Sammlungen anderer Ressourcen.
Sie können Sie Referenzen in der URL mit dem expand-Abfrageparameter erweitern, z. B. ?expand=fields
.
Sie können bestimmte Eigenschaften und Facets mit dem select Abfrageparameter abrufen, z. B. ?select=id,name
.
Standardmäßig werden die meisten Eigenschaften und Facets zurückgegeben, wohingegen alle Referenzen ausgeblendet werden.
Aus Leistungsgründen wird empfohlen, dass Sie select und expand nur für die Daten angeben, an denen Sie interessiert sind.
SharePoint-API-Stammressourcen
Die folgenden Beispiele sind relativ zu https://graph.microsoft.com/v1.0
.
Pfad | Beschreibung |
---|---|
/sites/root | Standardmäßige [Website][] der Organisation |
/sites/{site-id} | Zugriff auf eine bestimmte [Website][] anhand ihrer ID |
/sites/{site-id}/drive | Zugriff auf das standardmäßige Laufwerk (Dokumentbibliothek) für die angegebene [Website][] |
/sites/{site-id}/drives | Aufzählung der Laufwerke (Dokumentbibliotheken) unter der [Website][] |
/sites/{site-id}/sites | Aufzählung der Unterwebsites unter der site |
/sites/{site-id}/lists | Aufzählung der lists unter der site |
/sites/{site-id}/lists/{list-id}/items | Aufzählung der listItems unter der list |
/groups/{group-id}/sites/root | Zugriff auf die Teamwebsite einer Gruppe |
Websites können auch anhand des Pfads adressiert werden, indem der SharePoint-Hostname gefolgt von einem Doppelpunkt und dem relativen Pfad zur Website verwendet wird. Sie können optional wieder zur Adressierung des Ressourcenmodells übergehen, indem Sie einen Doppelpunkt am Ende einfügen.
Path | Beschreibung |
---|---|
/sites/contoso.sharepoint.com:/teams/hr | Die Seite ist https://contoso.sharepoint.com/teams/hr zugeordnet. |
/sites/contoso.sharepoint.com:/teams/hr:/drive | Zugriff auf das standardmäßige Laufwerk für diese Website |
Hinweis für bestehende SharePoint-Entwickler
Zwischen der Microsoft Graph-SharePoint-API und den CSOM-APIs bestehen einige wesentliche Unterschiede.
Die site-Ressource ist SPWeb
zugeordnet.
Die Stammwebsite (SPSite
) in einer Websitesammlung verfügt über ein siteCollection-Facet, das Informationen über enthält.
Da IDs für Websites nur innerhalb einer Websitesammlung eindeutig sind, müssen zur Adressierung einer Website nach ID sowohl die Websitesammlungs-ID als auch die Website-ID angegeben werden.
GET https://graph.microsoft.com/v1.0/sites/{hostname},{spsite-id},{spweb-id}/
Eine URL, die nur mit dem Hostnamen gebildet wird, verweist auf die Stammwebsite (SPWeb
) in der Standard-Websitesammlung.
GET https://graph.microsoft.com/v1.0/sites/{hostname}
Eine URL, die nur mit dem Hostnamen und der Websitesammlungs-ID (SPSite
) gebildet wird, verweist auf die Stammwebsite (SPWeb
) in der angegebenen Websitesammlung.
GET https://graph.microsoft.com/v1.0/sites/{hostname},{spsite-id}
Eine URL, die nur mit der Websitesammlungs-ID (SPSite
) gebildet wird, verweist auf die Stammwebsite (SPWeb
) in der angegebenen Websitesammlung.
GET https://graph.microsoft.com/v1.0/sites/{spsite-id}
Neuerungen
Informieren Sie sich über die aktuellsten neuen Features und Updates für diesen API-Satz.
Feedback
Feedback senden und anzeigen für