Arbeiten mit Dateien in Microsoft GraphWorking with files in Microsoft Graph

Mithilfe von Microsoft Graph können Sie eine App erstellen, die eine Verbindung mit Dateien in OneDrive-, OneDrive for Business- und SharePoint-Dokumentbibliotheken herstellt.You can use Microsoft Graph to create an app that connects with files across OneDrive, OneDrive for Business, and SharePoint document libraries. Mit Microsoft Graph können Sie verschiedene Möglichkeiten zum Umgang mit in Office 365 gespeicherten Dateien einrichten, angefangen vom einfachen Speichern von Dokumenten bis hin zu komplexen Dateifreigabeszenarien.With Microsoft Graph, you can build a variety of experiences with files stored in Office 365, from simply storing user documents to complex file sharing scenarios.

Microsoft Graph legt zwei Ressourcentypen für die Arbeit mit Dateien Offen:Microsoft Graph exposes two resource types for working with files:

  • Drive: Stellt einen logischen Container von Dateien wie z. B. eine Dokumentbibliothek oder OneDrive eines Benutzers dar.Drive - Represents a logical container of files, like a document library or a user's OneDrive.
  • DriveItem: Stellt ein Element innerhalb eines Laufwerks dar, wie z. B. ein Dokument, ein Foto, ein Video oder einen Ordner.DriveItem - Represents an item within a drive, like a document, photo, video, or folder.

Die meisten Interaktionen mit Dateien finden über Interaktionen mit DriveItem-Ressourcen statt. Es folgt ein Beispiel für eine DriveItem-Ressource:Most of the interaction with files occurs through interaction with DriveItem resources. The following is an example of a DriveItem resource:

{
  "@content.downloadUrl":"https://public-sn3302.files.1drv.com/y2pcT7OaUEExF7EHOlpTjCE55mIUoiX7H3sx1ff6I-nP35XUTBqZlnkh9FJhWb_pf9sZ7LEpEchvDznIbQig0hWBeidpwFkOqSKCwQylisarN6T0ecAeMvantizBUzM2PA1",
  "createdDateTime": "2016-09-16T03:37:04.72Z",
  "cTag": "aYzpENDY0OEYwNkM5MUQ5RDNEITU0OTI3LjI1Ng",
  "eTag": "aRDQ2NDhGMDZDOTFEOUQzRCE1NDkyNy4w",
  "id":"D4648F06C91D9D3D!54927",
  "lastModifiedBy": {
    "user": {
      "displayName": "Daron Spektor",
      "id": "d4648f06c91d9d3d"
    }
  },
  "name":"BritishShorthair.jpg",
  "size":35212,
  "image":{
    "height":398,
    "width":273
  },
  "file": {
    "hashes":{
      "sha1Hash":"wmgPQ6jrSeMX7JP1XmstQEGM2fc="
    }
  }
}

Drive- und DriveItem-Ressourcen legen Daten auf drei verschiedene Arten offen:Drive and DriveItem resources expose data in three different ways:

  • Eigenschaften (wie id und name) legen einfache Werte (Zeichenfolgen, Zahlen, boolesche Werte) offen.Properties (like id and name) expose simple values (strings, numbers, Booleans).
  • Facets (wie file und photo) legen komplexe Werte offen. Vorhandene file- oder folder-Facets geben Verhaltensweisen und Eigenschaften eines DriveItem an.Facets (like file and photo) expose complex values. The presence of file or folder facets indicates behaviors and properties of a DriveItem.
  • Referenzen (wie children und thumbnails) verweisen auf Sammlungen anderer Ressourcen.References (like children and thumbnails) point to collections of other resources.

Häufig verwendete RessourcenCommonly accessed resources

Die meisten API-Anforderungen für Dateiinteraktionen verwenden eine der folgenden grundlegenden Ressourcen für den Zugriff auf Drive oder DriveItem.Most API requests for file interactions will use one of these base resources to access a Drive or DriveItem.

PfadPath RessourceResource
/me/drive OneDrive eines BenutzersUser's OneDrive
/me/drives Listet die für den Benutzer verfügbaren OneDrive-Ressourcen auf.Enumerate OneDrive resources available to the user.
/drives/{drive-id} Greift auf ein bestimmtes Drive über die Laufwerks-ID zu.Access a specific Drive by the drive's ID.
/drives/{drive-id}/root/children Listet die DriveItem-Ressourcen in der Root eines spezifischen Drive auf.Enumerate the DriveItem resources in the root of a specific Drive.
/me/drive/items/{item-id} Greift auf ein DriveItem auf dem OneDrive des Benutzers über die eindeutige ID zu.Access a DriveItem in the user's OneDrive by its unique ID.
/me/drive/special/{special-id} Greift auf einen bestimmten (benannten) Ordner auf dem OneDrive des Benutzers über seinen bekannten Namen zu.Access a special (named) folder in the user's OneDrive by its known name.
/users/{user-id}/drive Greift auf das OneDrive eines anderen Benutzers mithilfe der eindeutigen ID des Benutzers zu.Access another user's OneDrive by using the user's unique ID.
/groups/{group-id}/drive Greift auf die Standarddokumentbibliothek für eine Gruppe mithilfe der eindeutigen ID der Gruppe zu.Access the default document library for a group by the group's unique ID.
/shares/{share-id} Greift auf ein DriveItem über seine SharedId oder eine Freigabe-URL zu.Access a DriveItem by its sharedId or sharing URL.
/sites/{site-id}/drive Zugriff auf das standardmäßige Laufwerk (Dokumentbibliothek) für die angegebene SharePoint-[Website][]Access the default drive (document library) for the given site.
/sites/{site-id}/drives Aufzählung der Laufwerke (Dokumentbibliotheken) unter der angegebenen SharePoint-[Website][]Enumerate the Drives (document libraries) under the given SharePoint site

Zusätzlich zur Adressierung eines DriveItem innerhalb eines Drive durch eine eindeutige ID kann die App ein DriveItem auch über einen relativen Pfad von einer bekannten Ressource adressieren. Zur Adressierung über einen Pfad wird das Doppelpunktzeichen (:) für das Escape des relativen Pfads verwendet. Diese Tabelle enthält ein Beispiel für unterschiedliche Methoden für die Verwendung des Doppelpunkts zur Adressierung eines Elements nach Pfad.In addition to addressing a DriveItem within a Drive by unique ID, your app can also address a DriveItem by relative path from a known resource. To address using a path, the colon (:) character is used to escape the relative path. This table provides an example of different ways to use the colon character to address an item by path.

PfadPath RessourceResource
/me/drive/root:/path/to/file Greift auf ein DriveItem über den Pfad relativ zum OneDrive-Stammordner des Benutzers zu.Access a DriveItem by path relative to the user's OneDrive root folder.
/me/drive/items/{item-id}:/path/to/file Greift auf ein DriveItem über einen Pfad relativ zu einem anderen Element zu (einem DriveItem mit einem folder-Facet).Access a DriveItem by path relative to another item (a DriveItem with a folder facet).
/me/drive/root:/path/to/folder:/children Listet die untergeordneten Elemente eines DriveItem über einen Pfad relativ zum Stammordner des OneDrive des Benutzers auf.List the children of a DriveItem by path relative to the root of the user's OneDrive.
/me/drive/items/{item-id}:/path/to/folder:/children Listet die untergeordneten Elemente eines DriveItem über einen Pfad relativ zu einem anderen Element auf.List the children of a DriveItem by path relative to another item.

Drive-RessourceDrive resource

Die Drive-Ressource ist das Objekt der obersten Ebene innerhalb des OneDrive eines Benutzers oder einer SharePoint-Dokumentbibliothek.The Drive resource is the top-level object within a user's OneDrive or a SharePoint document library. Fast alle Dateivorgänge beginnen damit, dass eine bestimmte Drive-Ressource adressiert wird.Nearly all files operations will start by addressing a specific drive resource.

Eine Drive-Ressource kann entweder von der eindeutigen ID des Laufwerks oder von dem Standardlaufwerk eines Benutzers, einer Gruppe, oder einer Organisation adressiert werden.A drive resource can be addressed either by the drive's unique ID or by the default drive for a User, Group, or organization.

DriveItem-RessourceDriveItem resource

DriveItems sind die Objekte innerhalb des Laufwerks-Dateisystems. Der Zugriff darauf erfolgt über ihre id unter Verwendung der /items/{item-id}-Syntax oder den Dateisystempfad unter Verwendung der/root:/path/to/item/-Syntax.DriveItems are the objects inside a drive's file system. They can be accessed by their id by using /items/{item-id} syntax, or by their file system path using the /root:/path/to/item/ syntax.

DriveItems verfügen Facets, die Daten zu den Identitäten und Funktionen der Elemente bereitstellen.DriveItems have facets that provide data about the item's identity and capabilities.

DriveItems mit einem folder-Facet fungieren als Container von Elementen und enthalten einen children-Verweis, der auf eine Sammlung von Elementen unter dem Ordner zeigt.DriveItems with a folder facet act as containers of items, and have a children reference, which points to a collection of items under the folder.

Freigegebene Ordner und RemoteelementeShared folders and remote items

Persönliche OneDrive-Benutzer können ein oder mehrere freigegebene Elemente von einem anderen Laufwerk zu ihrem eigenen OneDrive hinzufügen. Diese freigegebenen Elemente werden als DriveItem in der children-Sammlung mit einem remoteItem-Facet angezeigt.OneDrive personal users can add one or more shared items from another drive to their own OneDrive. These shared items appear as a DriveItem in the children collection with a remoteItem facet.

Weitere Informationen zum Arbeiten mit freigegebenen Ordnern und Remoteelementen finden Sie unter Remoteelemente und freigegebene Ordner.For more information about working with shared folders and remote items, see Remote items and shared folders.

Freigabe und BerechtigungenSharing and permissions

Eine der am häufigsten verwendeten Aktionen für OneDrive und SharePoint-Dokumentbibliotheken besteht im Freigeben von Inhalten für andere Personen. Über Microsoft Graph kann Ihre App Freigabelinks erstellen, Genehmigungen hinzufügen und Einladungen an Elemente eines Laufwerks senden.One of the most common actions for OneDrive and SharePoint document libraries is sharing content with other people. Microsoft Graph allows your app to create sharing links, add permissions and send invitations to items in a drive.

Microsoft Graph bietet der App auch eine Möglichkeit, Zugriff auf freigegebene Inhalte direkt über einen Freigabelinks zu erhalten.Microsoft Graph also provides a way for your app to access shared content directly from a sharing link.