Unterstützung von geteilten Ablagen implementieren

Geteilte Ablagen unterscheiden sich in „Meine Ablage“ nach den verschiedenen Modellen für Organisation, Freigabe und Eigentümerschaft. Wenn Ihre App Dateien in geteilten Ablagen erstellen und verwalten soll, müssen Sie die Unterstützung für geteilte Ablagen in Ihrer App implementieren. Die Komplexität der Implementierung hängt von den Funktionen Ihrer App ab.

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

Der Parameter supportsAllDrives=true informiert Google Drive darüber, dass Ihre Anwendung für die Verarbeitung von Dateien in geteilten Ablagen entwickelt wurde.

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

In einer geteilten Ablage nach Inhalten suchen

Verwenden Sie die Methode files.list, um nach freigegebenen Laufwerken zu suchen. In diesem Abschnitt werden spezifische Felder für freigegebene Ablagen in der files.list-Methode behandelt. Weitere Informationen zur Suche nach Dateien und Ordnern

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 die Ergebnisse einbezogen werden sollen. Wenn das Attribut nicht vorhanden oder auf „false“ gesetzt ist, werden keine Elemente aus geteilten Ablagen zurückgegeben.

• corpora: Textkörper von Elementen (Dateien/Dokumente), auf die die Abfrage angewendet wird. Unterstützte Rechtssubjekte sind user, domain, drive und allDrives. Verwenden Sie aus Effizienzgründen user oder drive anstelle von allDrives.

• 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 sind speziell für geteilte Ablagen vorgesehen:

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	Es werden alle Elemente in der angegebenen geteilten Ablage abgefragt. „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 bedeutet, dass einige Corpora bei dieser Anfrage nicht durchsucht wurden.
true	domain	Dateien werden abgefragt, die für die Domain freigegeben sind, einschließlich Dateien in geteilten Ablagen und in „Meine Ablage“.

Änderungen in einer geteilten Ablage im Blick behalten

Mit der Methode changes.list behalten Sie Änderungen in einer geteilten Ablage im Blick. In diesem Abschnitt werden spezifische Felder für freigegebene Ablagen in der Methode changes.list behandelt. Weitere Informationen finden Sie unter Änderungen für Nutzer und geteilte Ablagen im Blick behalten. Die changes.list-Methode enthält die folgenden freigegebenen Laufwerk-spezifischen Felder und Abfragemodi:

• driveId: Die geteilte Ablage, deren Änderungen zurückgegeben werden. Falls angegeben, beziehen sich die Änderungs-IDs auf Änderungen in der geteilten Ablage und nicht auf Änderungen an den Dateien, die dem Nutzer angezeigt werden. Wenn Sie sich auf eine bestimmte Änderung an einer geteilten Ablage beziehen möchten, müssen sowohl die ID der geteilten Ablage als auch die Änderungs-ID als Kennung verwendet werden.
• supportsAllDrives: Gibt an, ob die anfragende Anwendung freigegebene Laufwerke unterstützt. Wenn „false“ festgelegt ist, 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 aus geteilten Ablagen in die Änderungsliste aufgenommen werden sollen.

Die folgenden Abfragemodi sind speziell für geteilte Ablagen vorgesehen:

includeItemsFromAllDrives	driveId	Beschreibung der Anfrage
true	Nein	Änderungen spiegeln Änderungen an Dateien innerhalb oder außerhalb von geteilten Ablagen wider, auf die der Nutzer zugegriffen hat, sowie Änderungen an geteilten Ablagen, 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 Drive-Benutzeroberfläche auf freigegebene Drive-Inhalte zugreifen möchten, müssen Sie in der Google API Console die Option „Unterstützung für freigegebene Ablagen“ aktivieren. 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 in der Google Picker API.

Nächste Schritte

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