Unterstützung von geteilten Ablagen implementieren

Geteilte Ablagen sind von unterschiedlichen Organisationen, Freigaben und Inhaberschaften abhängig Modelle aus „Meine Ablage“. Wenn Ihre App Dateien auf freigegebenen Geräten Laufwerke verwenden möchten, müssen Sie die Unterstützung für geteilte Ablagen in Ihrer App implementieren. Die Komplexität der hängt von der Funktionalität Ihrer App ab.

Als Erstes müssen Sie den Abfrageparameter supportsAllDrives=true in wenn Ihre Anwendung die unten aufgeführten 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

Mit dem Parameter supportsAllDrives=true wird Google Drive mitgeteilt, ist darauf ausgelegt, Dateien in geteilten Ablagen zu verarbeiten.

Anwendungen, die Berechtigungen lesen oder ändern, Änderungen nachverfolgen oder in mehreren Korpora suchen, erfordern zusätzliche Funktionen für geteilte Ablagen. Im weiteren Verlauf dieses Dokuments werden zusätzliche Änderungen beschrieben, die erforderlich sind. für diese Aufgaben.

In einer geteilten Ablage nach Inhalten suchen

Suchen Sie mit der Methode files.list nach geteilten Ablagen. In diesem Abschnitt werden spezifische Felder für geteilte Ablagen im files.list-Methode. Informationen zur Suche nach geteilten Ablagen finden Sie unter Suchen Sie nach Dateien und Ordnern.

Die Methode files.list enthält Folgendes freigegebenes Drive-spezifische Felder und Abfragemodi:

  • driveId: ID der geteilten Ablage, in der gesucht werden soll.

  • includeItemsFromAllDrives – ob Elemente aus geteilten Ablagen eingeschlossen werden sollen in den Ergebnissen. Wenn nicht vorhanden oder auf „false“ gesetzt, werden Elemente der geteilten Ablage nicht zurückgegeben.

  • corpora: Elemente (Dateien/Dokumente), die an auf den die Abfrage angewendet wird. Unterstützte Textkörper sind user, domain, drive und allDrives. Für mehr Effizienz sollten user oder drive dem allDrives vorgezogen werden.

  • supportsAllDrives: gibt an, ob die anfragende Anwendung dies unterstützt. „Meine Ablage“ und geteilte Ablagen. Bei „false“ werden Elemente in geteilten Ablagen nicht die in der Antwort enthalten sind.

Die folgenden Abfragemodi gelten nur für geteilte Ablagen:

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

Änderungen in einer geteilten Ablage im Blick behalten

Änderungen mit der Methode changes.list nachverfolgen in einer geteilten Ablage. In diesem Abschnitt werden spezifische Felder für geteilte Ablagen im changes.list-Methode. Weitere Informationen finden Sie unter Änderungen für Nutzer und geteilte Ablagen im Blick behalten Die Methode changes.list enthält Folgendes freigegebenes Drive-spezifische Felder und Abfragemodi:

  • driveId: Die geteilte Ablage, deren Änderungen zurückgegeben werden. Wenn angegeben ist, beziehen sich die Änderungs-IDs auf Änderungen in der geteilten Ablage, nicht auf Änderungen an den Dateien, die dem Nutzer angezeigt werden. So verweisen Sie auf eine bestimmte geteilte Ablage: ändern, müssen sowohl die ID der geteilten Ablage als auch die Änderungs-ID als Kennung verwendet werden.
  • supportsAllDrives – gibt an, ob die anfragende Anwendung die Freigabe unterstützt fährt. Bei „false“ werden die Elemente der geteilten Ablage, einschließlich geteilter Ablagen und Dateien innerhalb einer geteilten Ablage werden nicht zurückgegeben.
  • includeItemsFromAllDrives: Gibt an, ob Dateien oder Änderungen in geteilten Ablagen in der Liste der Änderungen enthalten.

Die folgenden Abfragemodi gelten nur für geteilte Ablagen:

includeItemsFromAllDrives driveId Beschreibung der Anfrage
true Nein Änderungen spiegeln sich sowohl auf Änderungen an Dateien innerhalb oder außerhalb von geteilten Ablagen als auch auf Änderungen an geteilten Ablagen wider, in denen der Nutzer Mitglied ist.
true Ja Änderungen spiegeln sich auf Änderungen an der angegebenen geteilten Ablage und an Elementen darin wider.

Weitere Informationen zum Verhalten von Änderungsprotokollen finden Sie unter Änderungsprotokolle:

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

Wenn Sie über die Google Drive-Benutzeroberfläche auf Inhalte in geteilten Ablagen zugreifen möchten, aktivieren Sie das Kästchen neben „Unterstützung geteilter Ablagen“ in der Google API Console Weitere Informationen finden Sie unter Integration von Drive-UI 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 „Geteilte Ablagen“ Informationen in der Dateiauswahl finden Sie unter Google Picker API.

Nächste Schritte

Weiter mit „Geteilte Ablagen verwalten“ für Hier erfahren Sie, wie Sie geteilte Ablagen erstellen und Berechtigungen für geteilte Ablagen verwalten.