Dieser Leitfaden enthält Aufgaben im Zusammenhang mit der Verwaltung geteilter Ablagen, z. B. das Erstellen geteilter Ablagen und das Verwalten von Mitgliedern und Berechtigungen mit der Google Drive API.
Wenn Sie die Felder angeben möchten, die in der Antwort zurückgegeben werden sollen, können Sie den
fields System
parameter
mit einer beliebigen Methode der drives Ressource festlegen. Wenn Sie den Parameter fields nicht angeben, gibt der Server eine Standardgruppe von Feldern zurück, die für die Methode spezifisch sind. Die Methode
list gibt beispielsweise nur die Felder kind, id,
und name für jede geteilte Ablage zurück. Weitere Informationen finden Sie unter Bestimmte Felder zurückgeben.
Weitere Informationen zu den Beschränkungen für Ordner in geteilten Ablagen finden Sie unter Beschränkungen für Ordner in geteilten Ablagen.
Geteilte Ablage erstellen
Verwenden Sie die create
Methode für die drives Ressource mit dem
requestId Parameter, um eine geteilte Ablage zu erstellen.
Der Parameter requestId identifiziert den logischen Versuch zur idempotenten Erstellung einer geteilten Ablage. Wenn bei der Anfrage ein Zeitlimit überschritten wird oder ein unbestimmter Backend-Fehler zurückgegeben wird, kann dieselbe Anfrage wiederholt werden, ohne dass Duplikate erstellt werden. Der Parameter requestId und der Text der Anfrage müssen gleich bleiben.
Das folgende Codebeispiel zeigt, wie Sie eine geteilte Ablage erstellen:
Java
Python
Node.js
PHP
.NET
Aufrufe der create Methode sind
idempotent.
Wenn die geteilte Ablage bei einer vorherigen Anfrage oder aufgrund eines Wiederholungsversuchs erfolgreich erstellt wurde, gibt die Methode eine Instanz der Ressource drives zurück. Manchmal, z. B. nach längerer Zeit oder wenn sich der Text der Anfrage geändert hat, wird möglicherweise ein 409-Fehler zurückgegeben, der angibt, dass der Parameter requestId verworfen werden muss.
Geteilte Ablage abrufen
Verwenden Sie die
get Methode für die drives Ressource mit dem driveId Pfadparameter, um Metadaten für eine geteilte Ablage abzurufen. Wenn Sie die Ablage-ID nicht kennen, können Sie alle geteilten Ablagen mit der Methode list auflisten.
Die Methode get gibt eine geteilte Ablage als Instanz einer Ressource drives zurück.
Wenn Sie die Anfrage als Domainadministrator ausführen möchten, setzen Sie den Abfrageparameter useDomainAdminAccess auf true. Weitere Informationen finden Sie unter Geteilte Ablagen als
Domainadministrator verwalten.
Geteilte Ablagen auflisten
Verwenden Sie die list
Methode für die drives Ressource, um die geteilten Ablagen eines Nutzers aufzulisten. Die Methode gibt eine Liste der geteilten Ablagen zurück.
Übergeben Sie die folgenden Abfrageparameter, um die Paginierung anzupassen oder geteilte Ablagen zu filtern:
pageSize: Die maximale Anzahl der geteilten Ablagen, die pro Seite zurückgegeben werden sollen.pageToken: Ein Seitentoken, das von einem vorherigen Listenaufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.q: Abfragestring zum Suchen in geteilten Ablagen. Weitere Informationen finden Sie unter Nach geteilten Ablagen suchen.useDomainAdminAccess: Setzen Sie diesen Parameter auftrue, um die Anfrage als Domainadministrator auszuführen und alle geteilten Ablagen der Domain zurückzugeben, in der der Anfragende ein Administrator ist. Weitere Informationen finden Sie unter Geteilte Ablagen als Domainadministrator verwalten.
Geteilte Ablage aktualisieren
Verwenden Sie die update Methode für die
drives Ressource mit dem driveId Pfad
parameter, um die Metadaten für eine geteilte Ablage zu aktualisieren.
Die Methode gibt eine geteilte Ablage als Instanz einer Ressource drives zurück.
Wenn Sie die Anfrage als Domainadministrator ausführen möchten, setzen Sie den Abfrageparameter useDomainAdminAccess auf true. Weitere Informationen finden Sie unter Geteilte Ablagen als
Domainadministrator verwalten.
Geteilte Ablage ausblenden und einblenden
Verwenden Sie die hide Methode für die
drives Ressource mit dem driveId Parameter, um eine geteilte Ablage in der Standardansicht auszublenden.
Wenn eine geteilte Ablage ausgeblendet ist, wird die Ressource der geteilten Ablage in Drive als hidden=true gekennzeichnet. Ausgeblendete geteilte Ablagen werden nicht in der Drive-Benutzeroberfläche oder in der Liste der zurückgegebenen Dateien angezeigt.
Verwenden Sie die unhide Methode für die
drives Ressource mit dem driveId Parameter, um eine geteilte Ablage in der Standardansicht wiederherzustellen.
Beide Methoden geben eine geteilte Ablage als Instanz einer Ressource drives zurück.
Geteilte Ablage löschen
Verwenden Sie die
delete Methode für die drives Ressource mit dem driveId Parameter, um eine geteilte Ablage endgültig zu löschen.
Bevor Sie eine geteilte Ablage löschen, müssen alle Inhalte in den Papierkorb verschoben oder gelöscht werden. Der Nutzer muss außerdem die Rolle role=organizer für den Ordner der geteilten Ablage haben. Weitere Informationen finden Sie unter Dateien und Ordner in den Papierkorb verschieben oder löschen.
Übergeben Sie die folgenden Abfrageparameter, um geteilte Ablagen zu filtern:
useDomainAdminAccess: Setzen Sie diesen Parameter auftrue, um die Anfrage als Domainadministrator auszuführen und alle geteilten Ablagen der Domain zurückzugeben, in der der Anfragende ein Administrator ist. Weitere Informationen finden Sie unter Geteilte Ablagen als Domainadministrator verwalten.allowItemDeletion: Setzen Sie diesen Parameter auftrue, um Elemente in der geteilten Ablage zu löschen. Wird nur unterstützt, wennuseDomainAdminAccessebenfalls auftruegesetzt ist.
Mitglieder zu einer geteilten Ablage hinzufügen oder daraus entfernen
Verwenden Sie die
permissions Ressource, um Mitglieder zu einer geteilten Ablage hinzuzufügen oder daraus zu entfernen.
Erstellen Sie die Berechtigung für die geteilte Ablage, um ein Mitglied hinzuzufügen. Berechtigungsmethoden können auch für einzelne Dateien in einer geteilten Ablage verwendet werden, um Mitgliedern zusätzliche Berechtigungen zu gewähren oder Nichtmitgliedern die Zusammenarbeit an bestimmten Elementen zu ermöglichen.
Weitere Informationen und Beispielcode finden Sie unter Dateien, Ordner und Ablagen freigeben.
Geteilte Ablagen als Domainadministrator verwalten
Verwenden Sie den useDomainAdminAccess Parameter mit den drives und permissions
Ressourcen, um geteilte Ablagen in einer Organisation zu verwalten.
Nutzer, die diese Methoden mit useDomainAdminAccess=true aufrufen, müssen die
Drive and Docs Administrator
Berechtigung haben.
Administratoren können nach geteilten Ablagen suchen oder Berechtigungen für geteilte Ablagen aktualisieren, die ihrer Organisation gehören, unabhängig davon, ob der Administrator Mitglied einer bestimmten geteilten Ablage ist.
Wenn Sie Dienstkonten verwenden, müssen Sie möglicherweise die Identität eines authentifizierten Administrators annehmen, indem Sie die Identitätsübernahme des Dienstkontos verwenden. Beachten Sie, dass Dienstkonten im Gegensatz zu Nutzerkonten nicht zu Ihrer Google Workspace-Domain gehören. Wenn Sie Google Workspace-Assets wie Dokumente oder Ereignisse für Ihre gesamte Google Workspace-Domain freigeben, werden diese nicht für Dienstkonten freigegeben. Weitere Informationen finden Sie unter Dienstkonten übersicht.
Geteilte Ablage ohne Administrator wiederherstellen
Das folgende Codebeispiel zeigt, wie Sie geteilte Ablagen wiederherstellen, die keinen Administrator mehr haben.
Java
Python
Node.js
PHP
.NET
Verhindern, dass Nutzer Ihre Datei herunterladen, drucken oder kopieren
Sie können einschränken, wie Nutzer Dateien in geteilten Ablagen herunterladen, drucken und kopieren können.
Prüfen Sie das capabilities.canChangeDownloadRestriction boolesche Feld, um festzustellen, ob der Nutzer die vom Administrator angewendeten Einschränkungen für das Herunterladen einer geteilten Ablage
ändern kann. Wenn capabilities.canChangeDownloadRestriction auf true gesetzt ist, können Einschränkungen für das Herunterladen auf die geteilte Ablage angewendet werden. Weitere Informationen finden Sie unter
Dateifunktionen.
Die drives Ressource enthält eine Sammlung boolescher restrictions Felder, die angeben, ob eine Aktion für eine geteilte Ablage ausgeführt werden kann.
Einschränkungen gelten für eine geteilte Ablage oder Elemente in einer geteilten Ablage.
Einschränkungen können mit der drives.update Methode festgelegt werden.
Wenn Sie Einschränkungen für das Herunterladen auf eine geteilte Ablage anwenden möchten, kann ein Administrator der geteilten Ablage das
Feld restrictions.downloadRestriction der drives
Ressource mit dem
DownloadRestriction Objekt festlegen.
Wenn Sie das boolesche Feld restrictedForReaders auf true setzen, wird festgelegt, dass das Herunterladen und Kopieren für Leser eingeschränkt ist. Wenn Sie das boolesche Feld restrictedForWriters auf true setzen, wird festgelegt, dass das Herunterladen und Kopieren für Mitbearbeiter eingeschränkt ist. Wenn das Feld restrictedForWriters auf true gesetzt ist, ist das Herunterladen und Kopieren auch für Leser eingeschränkt. Wenn Sie restrictedForWriters auf true und restrictedForReaders auf false setzen, ist das gleichbedeutend damit, dass sowohl restrictedForWriters als auch restrictedForReaders auf true gesetzt sind.
Abwärtskompatibilität
Mit der Einführung des DownloadRestriction Objekts wurde die Funktionalität des
restrictions.copyRequiresWriterPermission
booleschen Felds aktualisiert.
Wenn Sie restrictions.copyRequiresWriterPermission jetzt auf true setzen, wird das
restrictedForReaders boolesche Feld des Objekts DownloadRestriction auf true gesetzt, um festzulegen, dass
das Herunterladen und Kopieren für Leser eingeschränkt ist.
Wenn Sie das Feld copyRequiresWriterPermission auf false setzen, werden sowohl die Felder restrictedForWriters als auch restrictedForReaders auf false gesetzt. Das bedeutet, dass die Einschränkungen für das Herunterladen oder Kopieren für alle Nutzer entfernt werden.
Felder, die die Funktionen zum Herunterladen, Drucken und Kopieren steuern
Die folgende Tabelle enthält die Felder der Ressource drives, die sich auf die Funktionen zum Herunterladen, Drucken und Kopieren auswirken:
| Feld | Beschreibung | Version |
|---|---|---|
capabilities.canCopy |
Gibt an, ob der aktuelle Nutzer Dateien in einer geteilten Ablage kopieren kann. | v2 und v3 |
capabilities.canDownload |
Gibt an, ob der aktuelle Nutzer Dateien in einer geteilten Ablage herunterladen kann. | v2 und v3 |
capabilities.canChangeCopyRequiresWriterPermission |
Gibt an, ob der aktuelle Nutzer die Einschränkung copyRequiresWriterPermission einer geteilten Ablage ändern kann. |
v2 und v3 |
capabilities.canResetDriveRestrictions |
Gibt an, ob der aktuelle Nutzer die Einschränkungen für die geteilte Ablage auf die Standardeinstellungen zurücksetzen kann. | v2 und v3 |
capabilities.canChangeDownloadRestriction |
Gibt an, ob der aktuelle Nutzer die Einschränkung für das Herunterladen einer geteilten Ablage ändern kann. | Nur v3 |
restrictions.copyRequiresWriterPermission |
Gibt an, ob die Optionen zum Kopieren, Drucken oder Herunterladen von Dateien in einer geteilten Ablage für Leser und Kommentatoren deaktiviert sind. Wenn true, wird das gleichnamige Feld für jede Datei in dieser geteilten Ablage auf true gesetzt. |
v2 und v3 |
restrictions.downloadRestriction |
Die Einschränkungen für das Herunterladen, die von Administratoren geteilter Ablagen angewendet werden. | Nur v3 |
Beschränkungen für Ordner
Für Ordner in geteilten Ablagen gelten einige Speicherbeschränkungen. Weitere Informationen finden Sie unter Beschränkungen für geteilte Ablagen in Google Drive.
Elementobergrenze
Jede geteilte Ablage eines Nutzers hat eine Beschränkung von 500.000 Elementen, einschließlich Dateien, Ordnern und Verknüpfungen.
Wenn das Limit erreicht ist, können in der geteilten Ablage keine Elemente mehr gespeichert werden. Wenn Nutzer wieder Dateien empfangen möchten, müssen sie Elemente endgültig aus der geteilten Ablage löschen. Beachten Sie, dass Elemente im Papierkorb auf das Limit angerechnet werden, endgültig gelöschte Elemente jedoch nicht. Weitere Informationen finden Sie unter Dateien und Ordner in den Papierkorb verschieben oder löschen.
Beschränkung für die Ordnerstruktur
Ein Ordner in einer geteilten Ablage darf maximal 100 Ebenen verschachtelter Ordner enthalten. Das bedeutet, dass ein untergeordneter Ordner nicht unter einem Ordner gespeichert werden kann, der mehr als 99 Ebenen tief ist. Diese Einschränkung gilt nur für untergeordnete Ordner.
Wenn Sie mehr als 100 Ordnerebenen hinzufügen möchten, wird eine
teamDriveHierarchyTooDeep
Antwort mit dem HTTP-Statuscode zurückgegeben.