Unterstützung von geteilten Ablagen implementieren

Für geteilte Ablagen gelten andere Organisations-, Freigabe- und Eigentumsmodelle als für „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. Der Aufwand für die Implementierung hängt von den Funktionen Ihrer App ab.

Dazu müssen Sie den Abfrageparameter supportsAllDrives=true in Ihre Anfragen einfügen, wenn Ihre App 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 für die Verarbeitung von Dateien in geteilten Ablagen konzipiert ist.

Anwendungen, die Berechtigungen lesen oder ändern, Änderungen verfolgen oder in mehreren Corpora suchen, benötigen zusätzliche Funktionen für geteilte Ablagen. Im restlichen Teil dieses Dokuments werden zusätzliche Änderungen beschrieben, die für die Ausführung dieser Aufgaben erforderlich sind.

Nach Inhalten in einer geteilten Ablage suchen

Verwenden Sie die list Methode für die files Ressource, um Nutzerdateien in geteilten Ablagen zu finden. Informationen zum Suchen nach einer geteilten Ablage finden Sie unter Nach geteilten Ablagen suchen.

Die Methode list enthält die folgenden abfragespezifischen Suchparameter für geteilte Ablagen:

driveId: ID der geteilten Ablage, in der gesucht werden soll.
corpora: Elemente (Dateien oder Dokumente), auf die sich die Abfrage bezieht. Unterstützte Corpora sind user, domain, drive und allDrives. Verwenden Sie aus Effizienzgründen user oder drive anstelle von allDrives. Standardmäßig ist „corpora“ auf user festgelegt.
includeItemsFromAllDrives: Gibt an, ob Elemente aus „Meine Ablage“ und aus geteilten Ablagen in die Ergebnisse aufgenommen werden sollen. Wenn dieser Parameter nicht vorhanden oder auf „false“ gesetzt ist, werden keine Elemente aus geteilten Ablagen zurückgegeben.
supportsAllDrives: Gibt an, ob die anfragende Anwendung sowohl „Meine Ablage“ als auch geteilte Ablagen unterstützt. Wenn der Wert „false“ ist, werden keine Elemente aus geteilten Ablagen in die Antwort aufgenommen.

Die folgenden Abfragemodi sind spezifisch für geteilte Ablagen:

`includeItemsFromAllDrives`	`corpora`	Beschreibung der Abfrage
`true`	`user`	Fragt Dateien ab, auf die der Nutzer zugegriffen hat, einschließlich Dateien aus geteilten Ablagen und aus „Meine Ablage“.
`true`	`domain`	Fragt Dateien ab, die für die Domain freigegeben wurden, einschließlich Dateien aus geteilten Ablagen und aus „Meine Ablage“.
`true`	`drive`	Fragt alle Elemente in der angegebenen geteilten Ablage ab. Die `driveId` muss in der Anfrage angegeben werden.
`true`	`allDrives`	Fragt Dateien ab, auf die der Nutzer zugegriffen hat, und alle geteilten Ablagen, in denen er Mitglied ist. Beachten Sie, dass die Antwort `incompleteSearch:true` enthalten kann. Das bedeutet, dass einige Corpora für diese Anfrage nicht durchsucht wurden.

Änderungen in einer geteilten Ablage verfolgen

Verwenden Sie die list Methode für die changes Ressource, um Änderungen in einer geteilten Ablage zu verfolgen. Weitere Informationen finden Sie unter Änderungen für Nutzer und geteilte Ablagen verfolgen.

Die Methode list enthält die folgenden abfragespezifischen Suchparameter für geteilte Ablagen:

driveId: Die geteilte Ablage, aus der Änderungen zurückgegeben werden. Wenn dieser Parameter angegeben ist, beziehen sich die Änderungs-IDs auf Änderungen an Elementen in der geteilten Ablage, die den aktuellen Status einer Datei angeben. Um auf eine bestimmte Änderung in einer geteilten Ablage zu verweisen, müssen sowohl die ID der geteilten Ablage als auch die Änderungs-ID als Kennung verwendet werden.
includeItemsFromAllDrives: Gibt an, ob Dateien oder Änderungen in geteilten Ablagen in die Liste der Änderungen aufgenommen werden sollen.
supportsAllDrives: Gibt an, ob die anfragende Anwendung geteilte Ablagen unterstützt. Wenn der Wert „false“ ist, werden keine Elemente aus geteilten Ablagen zurückgegeben, einschließlich geteilter Ablagen und Dateien in einer geteilten Ablage.

Die folgenden Abfragemodi sind spezifisch für geteilte Ablagen:

`includeItemsFromAllDrives`	`driveId`	Beschreibung der Abfrage
`true`	Nein	Die Ä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	Die Änderungen spiegeln Änderungen an der angegebenen geteilten Ablage und an Elementen in dieser geteilten Ablage wider.

Weitere Informationen zum Verhalten des Änderungsprotokolls finden Sie unter Änderungen für Nutzer und geteilte Ablagen.

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

Wenn Sie über die Drive-Benutzeroberfläche auf Inhalte in geteilten Ablagen zugreifen möchten, müssen Sie in der Google Cloud Console auf dem Tab Drive UI integration (Drive-Benutzeroberflächenintegration) der Google Drive API das Kästchen Shared drives support (Unterstützung für geteilte Ablagen) angekreuzt haben. Weitere Informationen finden Sie unter Drive-Benutzeroberflächenintegration konfigurieren.

Google Picker mit geteilten Ablagen verwenden

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

Geteilte Ablagen verwalten