Unterschiede zwischen geteilten Ablagen und My Drive API

Für geteilte Ablagen gelten andere Organisations-, Freigabe- und Eigentumsmodelle als für „Meine Ablage“. Daher sind einige „Meine Ablage“-Vorgänge für Inhalte in einer geteilten Ablage nicht zulässig. In diesem Dokument werden geteilte Ablage-spezifische API-Unterschiede beschrieben.

Files-Ressource

Die folgenden Felder werden nur für Dateien in einer geteilten Ablage ausgefüllt:

  • hasAugmentedPermissions: Gibt an, ob Nutzern direkt Dateizugriff auf diese Datei gewährt wird.
  • capabilities/canAddFolderFromAnotherDrive: Gibt an, ob der aktuelle Nutzer diesem Ordner einen Ordner aus einer anderen geteilten Ablage oder aus „Meine Ablage“ hinzufügen kann.
  • capabilities/canDeleteChildren: Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners löschen kann.
  • capabilities/canMoveChildrenOutOfDrive: Gibt an, ob der aktuelle Nutzer untergeordnete Ordner dieses Ordners außerhalb der geteilten Ablage verschieben kann.
  • capabilities/canMoveChildrenWithinDrive: Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners innerhalb der geteilten Ablage verschieben kann.
  • capabilities/canMoveItemWithinDrive: Gibt an, ob der aktuelle Nutzer dieses Element in der geteilten Ablage verschieben kann.
  • capabilities/canReadDrive: Gibt an, ob der aktuelle Nutzer Lesezugriff auf die geteilte Ablage hat, zu der diese Datei gehört.
  • capabilities/canTrashChildren: Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners in den Papierkorb verschieben kann.
  • driveId: Die ID der geteilten Ablage, in der sich die Datei befindet.
  • trashingUser: Wenn die Datei explizit in den Papierkorb verschoben wurde, der Nutzer, der sie dorthin verschoben hat.

  • trashedTime: Der Zeitpunkt, zu dem der Artikel in den Papierkorb verschoben wurde.

Die folgenden Felder werden für Dateien in einer geteilten Ablage nicht ausgefüllt:

  • permissions: Aufgrund der potenziellen Größe von ACLs für freigegebene Ablagen werden Berechtigungen nicht als Teil von Dateien zurückgegeben. Verwenden Sie die Methode permissions.list, die die Paginierung unterstützt, um Berechtigungen für eine Datei in einer geteilten Ablage oder für die geteilte Ablage selbst aufzulisten.
  • owners, ownerNames, ownedByMe: Dateien in einer geteilten Ablage gehören der geteilten Ablage, nicht einzelnen Nutzern.
  • folderColorRgb – Ordner können nicht einzeln eingefärbt werden
  • shared: Alle Elemente in einer geteilten Ablage werden freigegeben.
  • writersCanShare: Derzeit ist es nicht möglich, die Freigabe in geteilten Ablagen nach Rolle einzuschränken.

Die folgenden Felder werden nur festgelegt, wenn dem Nutzer Dateizugriffsberechtigungen für ein Element gewährt wurden:

  • sharedWithMeDate
  • sharingUser

Bei der Verwendung der folgenden Felder mit freigegebenen Laufwerken ist besondere Vorsicht geboten:

  • parents.isRoot: Dieses Feld ist nur für den Stammordner „Meine Ablage“ wahr. Für den obersten Ordner der geteilten Ablage ist es falsch.

  • parents: Ein übergeordnetes Element wird nicht in der Liste der übergeordneten Elemente angezeigt, wenn der anfragende Nutzer kein Mitglied der geteilten Ablage ist und keinen Zugriff auf das übergeordnete Element hat. Außerdem muss die Liste der übergeordneten Elemente mit Ausnahme des Ordners der obersten Ebene genau einen Eintrag enthalten, wenn sich die Datei auf einem freigegebenen Laufwerk befindet.

  • capabilities/canRemoveChildren – Verwenden Sie capabilities/canDeleteChildren oder capabilities/canTrashChildren.

Permissions-Ressource

Das Feld permissionDetails wird nur für Dateien in einer geteilten Ablage ausgefüllt. Dieses Feld enthält eine Liste der zusammengefassten Berechtigungen, die für diese Datei in der geteilten Ablage gelten oder von ihr übernommen wurden. Dieses Feld dient nur der Ausgabe und ist nur für Elemente in freigegebenen Ablagen vorhanden. Außerdem gilt:

  • wurden zwei neue Rollen organizer und fileOrganizer definiert.
  • permissions.list unterstützt jetzt die Paginierung.

Changes-Ressource

Die folgenden neuen Felder sind in der Changes-Ressource für ein freigegebenes Laufwerk verfügbar:

  • changeType: Die Art der Änderung. Mögliche Werte sind file und drive.
  • driveId: Die ID der geteilten Ablage, die mit dieser Änderung verknüpft ist.
  • drive: Der aktualisierte Status der geteilten Ablage. Wird angezeigt, wenn changeType = drive und der Nutzer noch Mitglied der geteilten Ablage ist.

Für Anwendungen, die Inhalte mit freigegebenen Laufwerken synchronisieren oder Aktivitäten erfassen müssen, sind möglicherweise zusätzliche Änderungen erforderlich. Weitere Informationen finden Sie unter Änderungen für Nutzer und geteilte Ablagen im Blick behalten.