Unterstützung von geteilten Ablagen implementieren

Geteilte Ablagen folgen anderen Organisations-, Freigabe- und Eigentumsmodellen als „Meine Ablage“. 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.

Zuerst müssen Sie den Abfrageparameter supportsAllDrives=true in Ihre Anfragen aufnehmen, wenn Ihre App die unten aufgeführten 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 restlichen Teil dieses Dokuments werden zusätzliche Änderungen beschrieben, die für die Ausführung 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 Methode files.list behandelt. Wie Sie nach einer geteilten Ablage suchen, erfahren Sie unter Nach Dateien und Ordnern suchen.

Die files.list-Methode enthält die folgenden freigegebenen Laufwerk-spezifischen Felder und Abfragemodi:

• 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. Wenn „false“ (falsch) festgelegt ist, werden Elemente in geteilten Ablagen nicht in die Antwort eingeschlossen.

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

includeItemsFromAllDrives	corpora	Beschreibung der Anfrage
true	user	Dateien werden abgefragt, auf die der Nutzer zugegriffen hat, einschließlich Dateien in geteilten Ablagen 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

Verwenden Sie die Methode changes.list, um Änderungen an einer geteilten Ablage im Blick zu behalten. In diesem Abschnitt werden spezifische Felder für freigegebene Ablagen in der changes.list-Methode 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, aus der Änderungen zurückgegeben werden. Falls angegeben, beziehen sich die Änderungs-IDs auf Änderungen in der geteilten Ablage, 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 in geteilten Ablagen in die Liste der Änderungen 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 Änderungen an der angegebenen geteilten Ablage und den darin enthaltenen Elementen 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

Die Dateiauswahl unterstützt die Auswahl von Elementen in geteilten Ablagen. 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 und Verwalten von Berechtigungen für geteilte Ablagen finden Sie unter Geteilte Ablagen verwalten.