Unterschiede zwischen geteilten Ablagen und My Drive API

Für geteilte Ablagen gelten andere Organisations-, Freigabe- und Eigentümermodelle als für „Meine Ablage“. Daher sind einige Vorgänge in „Meine Ablage“ für Inhalte in einer geteilten Ablage nicht zulässig.

In diesem Leitfaden werden die API-Unterschiede für geteilte Ablagen in den Ressourcen files und changes beschrieben.

Dateiressource

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

  • hasAugmentedPermissions: Gibt an, ob Nutzern der Dateizugriff direkt für diese Datei gewährt wurde.
  • capabilities/canAddFolderFromAnotherDrive: Gibt an, ob der aktuelle Nutzer diesem Ordner einen Ordner aus einem anderen Drive (einer anderen geteilten Ablage oder „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 Elemente dieses Ordners aus 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 der geteilten Ablage innerhalb 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 in den Papierkorb verschoben hat.
  • trashedTime: Der Zeitpunkt, zu dem das Element in den Papierkorb verschoben wurde. Wenn Sie die ältere Drive API v2 verwenden, heißt dieses Feld trashedDate.

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

  • permissions: Aufgrund der potenziellen Größe von Access Control Lists (ACLs) für geteilte 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 den Ordner der geteilten Ablage aufzulisten.
  • owners, ownerNames, ownedByMe: Dateien in einer geteilten Ablage gehören der geteilten Ablage und nicht einzelnen Nutzern.
  • folderColorRgb: Ordner können nicht einzeln farblich gekennzeichnet werden.
  • shared: Alle Elemente in einer geteilten Ablage sind freigegeben.
  • writersCanShare: Die Freigabe kann in geteilten Ablagen nicht nach Rolle eingeschränkt werden.

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 geteilten Ablagen sind besondere Aspekte zu beachten:

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

  • 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 ein Element enthalten, wenn sich die Datei in einer geteilten Ablage befindet.

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

Änderungsressource

Die folgenden neuen Felder sind in der changes Ressource für eine geteilte Ablage verfügbar:

  • changeType: Der Änderungstyp. 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. Vorhanden, wenn changeType den Wert drive hat und der Nutzer weiterhin Mitglied der geteilten Ablage ist.

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