In dieser Anleitung finden Sie 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.
Weitere Informationen zu Beschränkungen für Ordner in geteilten Ablagen finden Sie unter Beschränkungen für Ordner.
Geteilte Ablagen erstellen
Verwenden Sie zum Erstellen einer geteilten Ablage die Methode drives.create
.
Java
Python
Node.js
PHP
.NET
Aufrufe der Methode drives.create
sind idempotent.
Der Parameter requestId
gibt den logischen Versuch an, das freigegebene Laufwerk zu erstellen. Wenn für die Anfrage ein Zeitlimit überschritten wird oder ein unbestimmter Backend-Fehler zurückgegeben wird, kann die Anfrage wiederholt werden. Die requestId
und der Text der Anfrage müssen gleich bleiben.
Wenn die geteilte Ablage bei einer vorherigen Anfrage oder aufgrund eines Wiederholungsversuchs erfolgreich erstellt wurde, wird die normale Antwort zurückgegeben. 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 das requestId
verworfen werden muss.
Mitglieder einer geteilten Ablage hinzufügen oder entfernen
Mit der Ressource permissions
können Sie Mitglieder einer geteilten Ablage hinzufügen oder entfernen.
Wenn Sie ein Mitglied hinzufügen möchten, erstellen Sie die Berechtigung für die geteilte Ablage. Berechtigungsmethoden können auch für einzelne Dateien in einer geteilten Ablage verwendet werden, um Mitgliedern zusätzliche Berechtigungen zu erteilen oder Nichtmitgliedern die Zusammenarbeit an bestimmten Elementen zu ermöglichen.
Weitere Informationen und Beispielcode finden Sie unter Dateien, Ordner und Laufwerke freigeben.
Geteilte Ablagen löschen
Verwenden Sie die Methode drives.delete
, um eine geteilte Ablage zu löschen. Alle Inhalte in der geteilten Ablage müssen in den Papierkorb verschoben oder gelöscht werden, bevor die geteilte Ablage gelöscht werden kann.
Geteilte Ablagen für Domainadministratoren verwalten
Wenden Sie den Parameter useDomainAdminAccess
mit den Ressourcen drives
und permissions
an, um geteilte Ablagen in einer Organisation zu verwalten.
Nutzer, die diese Methoden mit useDomainAdminAccess=true
aufrufen, müssen die Drive and Docs
-Administratorberechtigung 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.
Geteilte Ablage ohne Organisator wiederherstellen
Das folgende Beispiel zeigt, wie Sie diese Ressourcen verwenden, um freigegebene Ablagen wiederherzustellen, die keinen Organisator 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 dürfen.
Ob der Nutzer die vom Organisator angewendeten Downloadbeschränkungen einer geteilten Ablage ändern kann, sehen Sie im booleschen Feld capabilities.canChangeDownloadRestriction
. Wenn capabilities.canChangeDownloadRestriction
auf true
festgelegt ist, können Downloadbeschränkungen auf die geteilte Ablage angewendet werden. Weitere Informationen finden Sie unter Dateifunktionen.
Die Ressource drives
enthält eine Sammlung von booleschen restrictions
-Feldern, 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 Methode drives.update
festgelegt werden.
Wenn Sie Downloadbeschränkungen für eine geteilte Ablage festlegen möchten, kann ein Administrator der geteilten Ablage das Feld restrictions.downloadRestriction
der Ressource drives
mit dem Objekt DownloadRestriction
festlegen.
Wenn Sie das boolesche Feld restrictedForReaders
auf true
setzen, wird deklariert, dass sowohl das Herunterladen als auch das Kopieren für Leser eingeschränkt sind. Wenn Sie das boolesche Feld restrictedForWriters
auf true
setzen, wird erklärt, dass sowohl das Herunterladen als auch das Kopieren für Autoren eingeschränkt sind. Wenn das Feld restrictedForWriters
den Wert true
hat, sind Download und Kopieren auch für Leser eingeschränkt. Wenn Sie restrictedForWriters
auf true
und restrictedForReaders
auf false
festlegen, ist das dasselbe, als wenn Sie sowohl restrictedForWriters
als auch restrictedForReaders
auf true
festlegen.
Abwärtskompatibilität
Mit der Einführung des Objekts DownloadRestriction
wurde die Funktionalität des booleschen Felds restrictions.copyRequiresWriterPermission
aktualisiert.
Wenn Sie restrictions.copyRequiresWriterPermission
auf true
setzen, wird das boolesche Feld restrictedForReaders
des Objekts DownloadRestriction
auf true
aktualisiert, um anzugeben, dass sowohl das Herunterladen als auch das Kopieren für Leser eingeschränkt sind.
Wenn Sie das Feld copyRequiresWriterPermission
auf false
setzen, werden sowohl das Feld restrictedForWriters
als auch das Feld restrictedForReaders
auf false
aktualisiert. Das bedeutet, dass die Einstellungen für Download- oder Kopierbeschränkungen für alle Nutzer entfernt werden.
Felder, mit denen die Funktionen zum Herunterladen, Drucken und Kopieren gesteuert werden
In der folgenden Tabelle sind die Ressourcenfelder für drives
aufgeführt, die sich auf die Download-, Druck- und Kopierfunktionen 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 copyRequiresWriterPermission -Einschränkung einer geteilten Ablage ändern kann. |
v2 und v3 |
capabilities.canResetDriveRestrictions |
Gibt an, ob der aktuelle Nutzer die Einschränkungen der geteilten Ablage auf die Standardeinstellungen zurücksetzen kann. | v2 und v3 |
capabilities.canChangeDownloadRestriction |
Gibt an, ob der aktuelle Nutzer die Downloadbeschränkung 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 alle Dateien in dieser geteilten Ablage auf true gesetzt. |
v2 und v3 |
restrictions.downloadRestriction |
Die von Administratoren für geteilte Ablagen angewendeten Downloadbeschränkungen. | Nur v3 |
Beschränkungen für Ordner
Für Ordner in geteilten Ablagen gelten einige Speicherlimits. Weitere Informationen finden Sie im Hilfeartikel Beschränkungen für geteilte Ablagen in Google Drive.
Elementobergrenze
Pro Ordner in der geteilten Ablage eines Nutzers sind 500.000 Elemente zulässig, darunter Dateien, Ordner und Verknüpfungen.
Wenn das Limit erreicht ist, können in der geteilten Ablage keine Elemente mehr gespeichert werden. Damit Nutzer wieder Dateien empfangen können, müssen sie Elemente aus dem Ordner endgültig löschen. Hinweis: Elemente im Papierkorb werden auf das Limit angerechnet, endgültig gelöschte Elemente jedoch nicht. Weitere Informationen finden Sie unter Dateien und Ordner in den Papierkorb verschieben oder löschen.
Beschränkung der Ordnertiefe
Ein Ordner in einer geteilten Ablage darf nicht mehr als 100 Ebenen verschachtelter Ordner beinhalten. Das bedeutet, dass ein untergeordneter Ordner nicht in einem Ordner gespeichert werden kann, der mehr als 99 Ebenen tief verschachtelt ist. Diese Einschränkung gilt nur für untergeordnete Ordner.
Wenn Sie versuchen, mehr als 100 Ebenen von Ordnern hinzuzufügen, wird der HTTP-Statuscode teamDriveHierarchyTooDeep
zurückgegeben.