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 sinduser
,domain
,drive
undallDrives
. Aus Effizienzgründen sollten Sieuser
oderdrive
gegenüberallDrives
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.