Unterschiede zwischen geteilten Ablagen und My Drive API

Geteilte Ablagen richten sich nach unterschiedlichen Organisations-, Freigabe- und Inhabermodellen von „Meine Ablage“. Daher sind einige Vorgänge in „Meine Ablage“ für Inhalte in geteilten Ablagen nicht zulässig. In diesem Dokument werden die API-Unterschiede zwischen geteilten Ablagen beschrieben.

Files-Ressource

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

  • 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 Elemente dieses Ordners aus der geteilten Ablage verschieben kann.
  • capabilities/canMoveChildrenWithinDrive: Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners in der geteilten Ablage verschieben darf.
  • 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, ist der Nutzer, der sie in den Papierkorb verschoben hat.

  • trashedTime: Der Zeitpunkt, zu dem das Element in den Papierkorb verschoben wurde.

Für Dateien in geteilten Ablagen werden die folgenden Felder nicht ausgefüllt:

  • permissions: Aufgrund der potenziellen Größe von 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 in der geteilten 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 farbig dargestellt werden
  • shared: Alle Elemente in einer geteilten Ablage sind freigegeben.
  • writersCanShare: Es ist derzeit nicht möglich, die Freigabe nach Rolle in geteilten Ablagen einzuschränken.

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

  • sharedWithMeDate
  • sharingUser

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

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

  • parents: Ein übergeordnetes Element wird nicht in der Liste der übergeordneten Elemente aufgeführt, wenn der anfragende Nutzer kein Mitglied der geteilten Ablage ist und keinen Zugriff auf die übergeordnete Datei hat. Wenn sich die Datei in einer geteilten Ablage befindet, muss die übergeordnete Liste mit Ausnahme des übergeordneten Ordners genau ein Element enthalten.

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

Permissions-Ressource

Das Feld permissionDetails wird nur für Dateien ausgefüllt, die sich in einer geteilten Ablage befinden. Dieses Feld enthält eine Liste zusammengefasster Berechtigungen, die für diese Datei der geteilten Ablage gelten oder von ihr übernommen werden. Dieses Feld dient nur zur Ausgabe und ist nur für Elemente in geteilten Ablagen vorhanden. Außerdem können Sie

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

Changes-Ressource

Die folgenden neuen Felder sind in der Ressource Changes für geteilte Ablagen verfügbar:

  • changeType: Die Art der Änderung. Mögliche Werte sind file und drive.
  • driveId: Die ID der geteilten Ablage, auf die diese Änderung angewendet wird.
  • drive: Der aktualisierte Status der geteilten Ablage. Vorhanden, wenn changeType den Wert drive hat und der Nutzer noch Mitglied der geteilten Ablage ist.

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