Unterschiede zwischen geteilten Ablagen und My Drive API

Geteilte Ablagen sind von unterschiedlichen Organisationen, Freigaben und Inhaberschaften abhängig Modelle aus „Meine Ablage“. Daher sind einige Vorgänge in „Meine Ablage“ für in einer geteilten Ablage. In diesem Dokument wird beschrieben, API-Unterschiede

Files-Ressource

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

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

  • trashedTime: Der Zeitpunkt, zu dem das Element 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 in geteilten Ablagen sind Berechtigungen nicht als Teil von Dateien zurückgegeben. Verwenden Sie die Methode permissions.list, die Paginierung unterstützt, um Berechtigungen für eine Datei innerhalb einer geteilte Ablage oder die geteilte Ablage selbst.
  • owners, ownerNames, ownedByMe – Dateien in einer geteilten Ablage werden gehören der geteilten Ablage, nicht einzelnen Nutzern.
  • folderColorRgb: Ordner können nicht einzeln eingefärbt werden.
  • shared: Alle Elemente in einer geteilten Ablage sind freigegeben.
  • writersCanShare: Derzeit ist es nicht möglich, die Freigabe durch Rolle in geteilten Ablagen.

Die folgenden Felder werden nur festgelegt, wenn dem Nutzer Dateizugriff gewährt wurde Berechtigungen für ein Element:

  • sharedWithMeDate
  • sharingUser

Die folgenden Felder müssen besonders beachtet werden, wenn Sie sie mit Geteilte Ablagen:

  • parents.isRoot: Dieses Feld gilt nur für den Stammordner „Meine Ablage“. „false“ für den übergeordneten Ordner der geteilten Ablage.

  • parents: Ein übergeordnetes Element wird nicht in der Liste der übergeordneten Elemente angezeigt, wenn anfragender Nutzer ist kein Mitglied der geteilten Ablage und hat keinen Zugriff an das übergeordnete Element. Außerdem ist mit Ausnahme des Ordners der obersten Ebene der Ordner Die Liste der übergeordneten Elemente muss genau ein Element enthalten, wenn sich die Datei in einem geteilte Ablage.

  • capabilities/canRemoveChildren – capabilities/canDeleteChildren verwenden oder capabilities/canTrashChildren.

Permissions-Ressource

Das Feld permissionDetails wird nur für Dateien ausgefüllt, die sich in einem geteilte Ablage. Dieses Feld enthält eine Liste zusammengefasster Berechtigungen, die oder von dieser Datei in der geteilten Ablage übernommen. Dieses Feld dient nur zur Ausgabe. ist nur für Elemente in geteilten Ablagen vorhanden. Außerdem

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

Changes-Ressource

Die folgenden neuen Felder sind in der Ressource Changes für ein geteilte Ablage:

  • 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. Präsentieren, wenn changeType ist drive und der Nutzer ist noch Mitglied der geteilten Ablage.

Für Anwendungen, die synchronisiert werden müssen, sind möglicherweise zusätzliche Änderungen erforderlich mit geteilten Ablagen zu teilen oder Aktivitäten zu verfolgen. Weitere Informationen finden Sie unter Änderungen für Nutzer und geteilte Ablagen im Blick behalten