Arbeiten mit SharePoint-Websites in Microsoft GraphWorking with SharePoint sites in Microsoft Graph

Die SharePoint-API in Microsoft Graph unterstützt die folgenden wesentlichen Szenarios:The SharePoint API in Microsoft Graph supports the following core scenarios:

  • Zugriff auf SharePoint-Websites, -Listen und -Laufwerke (Dokumentbibliotheken)Access to SharePoint sites, lists, and drives (document libraries)
  • Schreibgeschützte Unterstützung für Website-Ressourcen (keine Möglichkeit zum Erstellen neuer Websites)Read-only support for site resources (no ability to create new sites)
  • Lese-/ Schreibzugriff-Unterstützung für -Listen, listItems und driveItemsRead-write support for lists, listItems, and driveItems
  • Adressierung von Ressourcen nach SharePoint-ID, URL oder relativem PfadAddress resources by SharePoint ID, URL, or relative path

Die SharePoint-API macht drei wichtige Ressourcentypen verfügbar:The SharePoint API exposes three major resource types:

Es folgt ein Beispiel für eine listItem-Ressource:The following is an example of a listItem resource.

{
  "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:Resources expose data in three different ways:

  • Eigenschaften (wie id und name) legen einfache Werte offen.Properties (like id and name) expose simple values.
  • Facets (wie fields und createdBy) legen komplexe Werte offen.Facets (like fields and createdBy) expose complex values.
  • References (wie items) verweisen auf Sammlungen anderer Ressourcen.References (like items) point to collections of other resources.

Sie können Sie Referenzen in der URL mit dem expand-Abfrageparameter erweitern, z. B. ?expand=fields.You can expand references in your URL with the expand query parameter; for example, ?expand=fields. Sie können bestimmte Eigenschaften und Facets mit dem select Abfrageparameter abrufen, z. B. ?select=id,name.You can request specific properties and facets with the select query parameter; for example, ?select=id,name. Standardmäßig werden die meisten Eigenschaften und Facets zurückgegeben, wohingegen alle Referenzen ausgeblendet werden.By default, most properties and facets are returned while all references are hidden. Aus Leistungsgründen wird empfohlen, dass Sie select und expand nur für die Daten angeben, an denen Sie interessiert sind.For efficiency, we recommend that you specify select and expand to only return the data you care about.

SharePoint-API-StammressourcenSharePoint API root resources

Die folgenden Beispiele sind relativ zu https://graph.microsoft.com/v1.0.The following examples are relative to https://graph.microsoft.com/v1.0.

PfadPath BeschreibungDescription
/sites/root/sites/root Standardmäßige [Website][] der OrganisationOrganization's default site.
/sites/{site-id}/sites/{site-id} Zugriff auf eine bestimmte [Website][] anhand ihrer IDAccess a specific site by its ID.
/sites/{site-id}/drive/sites/{site-id}/drive Zugriff auf das standardmäßige Laufwerk (Dokumentbibliothek) für die angegebene [Website][]Access the default drive (document library) for the given site.
/sites/{site-id}/drives/sites/{site-id}/drives Aufzählung der Laufwerke (Dokumentbibliotheken) unter der [Website][]Enumerate the drives (document libraries) under the site.
/sites/{site-id}/sites/sites/{site-id}/sites Aufzählung der Unterwebsites unter der siteEnumerate the sub-sites under the site.
/sites/{site-id}/lists/sites/{site-id}/lists Aufzählung der lists unter der siteEnumerate the lists under the site.
/sites/{site-id}/lists/{list-id}/items/sites/{site-id}/lists/{list-id}/items Aufzählung der listItems unter der listEnumerate the listItems under the list.
/groups/{group-id}/sites/root/groups/{group-id}/sites/root Zugriff auf die Teamwebsite einer GruppeAccess a group's team site.

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.Sites can also be addressed by path by using the SharePoint hostname, followed by a colon and the relative path to the site. You can optionally transition back to addressing the resource model by putting another colon at the end.

PfadPath BeschreibungDescription
/sites/contoso.sharepoint.com:/teams/hr/sites/contoso.sharepoint.com:/teams/hr Die Website zugeordnethttps://contoso.sharepoint.com/teams/hrThe site associated with https://contoso.sharepoint.com/teams/hr
/sites/contoso.sharepoint.com:/teams/hr:/drive/sites/contoso.sharepoint.com:/teams/hr:/drive Zugriff auf das standardmäßige Laufwerk für diese WebsiteAccess the default drive for this site.

Hinweis für bestehende SharePoint-EntwicklerNote for existing SharePoint developers

Zwischen der Microsoft Graph-SharePoint-API und den CSOM-APIs bestehen einige wesentliche Unterschiede. Die site-Ressource ist SPWeb zugeordnet. Die Stammwebsite (SPWeb) in einer Websitesammlung verfügt über ein siteCollection-Facet, das Informationen über SPSite 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.The Microsoft Graph SharePoint API has a few key differences with the CSOM APIs. The site resource maps to SPWeb. The root site (SPWeb) in a site collection has a siteCollection facet, which contains information about the SPSite. Because IDs for sites are only unique within their site collection, addressing a site by ID requires providing both the site collection identifier and the site identifier.

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.A URL constructed with only the hostname will point to the root site (SPWeb) in the default site collection.

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.A URL constructed with only the hostname and siteCollection (SPSite) ID will point to the root site (SPWeb) in the given site collection.

GET https://graph.microsoft.com/v1.0/sites/{hostname},{spsite-id}