Unterstützung von geteilten Ablagen implementieren

Geteilte Ablagen richten sich nach unterschiedlichen Organisations-, Freigabe- und Inhabermodellen wie „Meine Ablage“. Wenn Ihre Anwendung Dateien in geteilten Ablagen erstellen und verwalten soll, müssen Sie die Unterstützung für geteilte Ablagen implementieren. Die Komplexität der Implementierung hängt von der Funktionalität der Anwendung ab.

Zuerst müssen Sie den Abfrageparameter supportsAllDrives=true in Ihre Anfragen aufnehmen, wenn Ihre Anwendung die folgenden Vorgänge ausführt:

Drive API Version 3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API Version 2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

Der Parameter supportsAllDrives=true informiert Google Drive darüber, dass Ihre Anwendung Dateien in geteilten Ablagen verarbeiten kann.

Anwendungen, die Berechtigungen lesen oder ändern, Änderungen verfolgen oder in mehreren Korpora suchen müssen, erfordern zusätzliche Funktionen für geteilte Ablagen. Im weiteren Verlauf dieses Dokuments werden zusätzliche Änderungen beschrieben, die zum Ausführen dieser Aufgaben erforderlich sind.

Inhalte in einer geteilten Ablage suchen

Verwenden Sie die Methode files.list, um nach geteilten Ablagen zu suchen. In diesem Abschnitt werden Felder für geteilte Ablagen in der Methode files.list beschrieben. Weitere Informationen finden Sie im Hilfeartikel Nach Dateien und Ordnern suchen.

Die Methode files.list enthält die folgenden Felder und Abfragemodi für geteilte Ablagen:

  • driveId – ID der geteilten Ablage, in der gesucht werden soll.
  • includeItemsFromAllDrives: Gibt an, ob Elemente aus geteilten Ablagen in Ergebnissen enthalten sein sollen. Wenn dieser Parameter nicht vorhanden oder auf „false“ gesetzt ist, werden keine Elemente in geteilten Ablagen zurückgegeben.

  • corpora: Text von Elementen (Dateien/Dokumente), auf den die Abfrage angewendet wird. Unterstützte Textkörper sind user, domain, drive und allDrives. Aus Effizienzgründen sollten Sie user oder drive gegenüber allDrives vorziehen.

  • supportsAllDrives: Gibt an, ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. Bei „false“ werden Elemente aus geteilten Ablagen nicht in die Antwort aufgenommen.

Die folgenden Abfragemodi gelten speziell für geteilte Ablagen:

includeItemsFromAllDrives corpora Beschreibung der Anfrage
true user Fragt Dateien ab, auf die der Nutzer zugegriffen hat, einschließlich Dateien in geteilten Ablagen und Dateien aus „Meine Ablage“.
true drive Fragt alle Elemente in der angegebenen geteilten Ablage ab. driveId muss in der Anfrage angegeben werden.
true allDrives Fragt Dateien ab, auf die der Nutzer zugegriffen hat, sowie in allen geteilten Ablagen, in denen er Mitglied ist. Die Antwort kann incompleteSearch : true enthalten, was darauf hinweist, dass für diese Anfrage nicht nach Korpora gesucht wurde.
true domain Abfragedateien, die für die Domain freigegeben sind, einschließlich Dateien aus geteilten Ablagen und aus „Meine Ablage“.

Änderungen an geteilten Ablagen im Blick behalten

Verwenden Sie die Methode changes.list, um Änderungen an einer geteilten Ablage zu verfolgen. In diesem Abschnitt werden Felder für geteilte Ablagen in der Methode changes.list beschrieben. Weitere Informationen finden Sie im Hilfeartikel Änderungen für Nutzer und geteilte Ablagen erfassen. Die Methode changes.list enthält die folgenden Felder und Abfragemodi für geteilte Ablagen:

  • driveId: Die geteilte Ablage, aus der Änderungen zurückgegeben werden. Falls angegeben, beziehen sich die Änderungs-IDs auf Änderungen innerhalb der geteilten Ablage, nicht auf Änderungen an den Dateien, die dem Nutzer angezeigt werden. Wenn Sie auf eine bestimmte Änderung in einer geteilten Ablage verweisen möchten, muss sowohl die ID der geteilten Ablage als auch die Änderungs-ID als Kennung verwendet werden.
  • supportsAllDrives: Gibt an, ob die anfragende Anwendung geteilte Ablagen unterstützt. Bei „false“ werden Elemente in geteilten Ablagen, einschließlich geteilter Ablagen und Dateien in einer geteilten Ablage, nicht zurückgegeben.
  • includeItemsFromAllDrives: Gibt an, ob Dateien oder Änderungen in geteilten Ablagen in die Liste der Änderungen aufgenommen werden sollen.

Die folgenden Abfragemodi gelten speziell für geteilte Ablagen:

includeItemsFromAllDrives driveId Beschreibung der Anfrage
true Nein Die Änderungen beziehen sich sowohl auf Änderungen an Dateien innerhalb oder außerhalb von geteilten Ablagen, auf die der Nutzer zugegriffen hat, als auch auf Änderungen an geteilten Ablagen, in denen der Nutzer Mitglied ist.
true Ja Änderungen gelten für Änderungen an der angegebenen geteilten Ablage und an Elementen darin.

Weitere Informationen zum Verhalten von Änderungslogs finden Sie unter Änderungslogs.

Unterstützung für geteilte Ablagen in der Drive-Benutzeroberfläche aktivieren

Wenn Sie über die Drive-Benutzeroberfläche auf Inhalte geteilter Ablagen zugreifen möchten, müssen Sie in der Google API Console unter „Unterstützung für geteilte Ablagen“ prüfen. Weitere Informationen finden Sie unter Drive-UI-Integration konfigurieren.

Dateiauswahl mit geteilten Ablagen verwenden

Mit der Dateiauswahl können Sie Elemente in geteilten Ablagen auswählen. Weitere Informationen zum Aktivieren der Unterstützung für geteilte Ablagen und zum Hinzufügen der Ansicht für geteilte Ablagen in der Dateiauswahl finden Sie unter Google Picker API.

Nächste Schritte

Unter Geteilte Ablagen verwalten finden Sie weitere Informationen zum Erstellen von geteilten Ablagen und zum Verwalten von Berechtigungen für geteilte Ablagen.