Unterschiede zwischen geteilten Ablagen und My Drive API
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Geteilte Ablagen folgen anderen Organisations-, Freigabe- und Eigentumsmodellen als „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.
Dateiresource
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 wird.capabilities/canAddFolderFromAnotherDrive: Gibt an, ob der aktuelle Nutzer diesem Ordner einen Ordner aus einem anderen Laufwerk (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 das freigegebene Laufwerk hat, zu dem diese Datei gehört.capabilities/canTrashChildren: Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners in den Papierkorb verschieben kann.driveId: Die ID des freigegebenen Laufwerks, auf dem 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 im 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 eingefärbt werden.shared: Alle Elemente in einer geteilten Ablage werden freigegeben.writersCanShare: Die Freigabe kann in geteilten Ablagen nicht nach Rolle eingeschränkt werden.
Die folgenden Felder werden nur festgelegt, wenn dem Nutzer die Berechtigung für den Dateizugriff für ein Element erteilt wurde:
sharedWithMeDatesharingUser
Die folgenden Felder erfordern besondere Aufmerksamkeit, wenn Sie sie mit freigegebenen Ablagen verwenden:
parents.isRoot: Dieses Feld ist nur für den Stammordner von „Meine Ablage“ wahr. Für den Ordner der obersten Ebene der geteilten Ablage ist es falsch.parents: Ein Elternteil wird nicht in der Liste der Eltern angezeigt, wenn der anfragende Nutzer kein Mitglied der geteilten Ablage ist und keinen Zugriff auf das Elternteil hat. Mit Ausnahme des Ordners der obersten Ebene muss die Liste „parents“ genau ein Element enthalten, wenn sich die Datei in einer geteilten Ablage befindet.
capabilities/canRemoveChildren: Verwenden Sie capabilities/canDeleteChildren oder capabilities/canTrashChildren.
Ressource ändern
Die folgenden neuen Felder sind für eine geteilte Ablage in der Ressource changes 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 des freigegebenen Laufwerks. Wird angezeigt, wenn changeType gleich drive ist und der Nutzer weiterhin Mitglied der geteilten Ablage ist.
Für Anwendungen, die Inhalte mit freigegebenen Ablagen synchronisieren oder Aktivitäten verfolgen müssen, sind möglicherweise zusätzliche Änderungen erforderlich. Weitere Informationen finden Sie unter Änderungen für Nutzer und geteilte Ablagen nachverfolgen.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[],[],null,["# Shared drive versus My Drive API differences\n\nShared drives follow different organization, sharing, and ownership models from\na My Drive. As such, some My Drive operations\naren't permitted for content in a shared drive.\n\nThis guide outlines shared drive-specific API differences in the `files` and\n`changes` resources.\n\nFile resource\n-------------\n\nThe following fields in the [`files`](/workspace/drive/api/reference/rest/v3/files) resource are\nonly populated for files located within a shared drive:\n\n- `hasAugmentedPermissions`: Whether any users are granted file access directly on this file.\n- `capabilities/canAddFolderFromAnotherDrive`: Whether the current user can add a folder from another drive (a different shared drive or My Drive) to this folder.\n- `capabilities/canDeleteChildren`: Whether the current user can delete children of this folder.\n- `capabilities/canMoveChildrenOutOfDrive`: Whether the current user can move children of this folder outside of the shared drive.\n- `capabilities/canMoveChildrenWithinDrive`: Whether the current user can move children of this folder within the shared drive.\n- `capabilities/canMoveItemWithinDrive`: Whether the current user can move this shared drive item within the shared drive.\n- `capabilities/canReadDrive`: Whether the current user has read access to the shared drive to which this file belongs.\n- `capabilities/canTrashChildren`: Whether the current user can trash children of this folder.\n- `driveId`: The ID of the shared drive where the file is located.\n- `trashingUser`: If the file has been explicitly trashed, the user who trashed it.\n- `trashedTime`: The time that the item was trashed. If you're using the older Drive API v2, this field is called `trashedDate`.\n\nThe following fields aren't populated for files located within a shared drive:\n\n- `permissions`: Due to the potential size of shared drive access control lists (ACLs), permissions aren't returned as part of files. Use the `permissions.list` method, which supports pagination, to list permissions for a file within a shared drive or the shared drive folder.\n- `owners`, `ownerNames`, `ownedByMe`: Files within a shared drive are owned by the shared drive, not individual users.\n- `folderColorRgb`: Folders cannot be colored individually.\n- `shared`: All items in a shared drive are shared.\n- `writersCanShare`: It's not possible to restrict sharing by role in shared drives.\n\nThe following fields are only set when the user has been granted file access\npermissions on an item:\n\n- `sharedWithMeDate`\n- `sharingUser`\n\nThe following fields require special consideration when you use them with shared\ndrives:\n\n- `parents.isRoot`: This field is only true for the My Drive root folder; it's false for the shared drive top-level folder.\n- `parents`: A parent doesn't appear in the parents list if the requesting\n user isn't a member of the shared drive and doesn't have access to the\n parent. In addition, with the exception of the top level folder, the parents\n list must contain exactly one item if the file is located within a shared\n drive.\n\n | **Note:** If you're using the older Drive API v2:\n | - `shareable`: Deprecated. Use `capabilities/canShare`.\n | - `editable`: Deprecated. Use `capabilities/canEdit`.\n | - `copyable`: Deprecated. Use `capabilities/canCopy`.\n | - `canComment`: Deprecated. Use `capabilities/canComment`.\n | - `canReadRevisions`: Deprecated. Use `capabilities/canReadRevisions`.\n- `capabilities/canRemoveChildren`: Use `capabilities/canDeleteChildren` or\n `capabilities/canTrashChildren`.\n\nChange resource\n---------------\n\nThe following new fields are available in the\n[`changes`](/workspace/drive/api/reference/rest/v3/changes) resource for a shared drive:\n\n- `changeType`: The change type. Possible values are `file` and `drive`.\n- `driveId`: The ID of the shared drive associated with this change.\n- `drive`: The updated state of the shared drive. Present if the `changeType` is `drive` and the user is still a member of the shared drive.\n\nAdditional changes might be required for applications that need to sync content\nwith shared drives or track activity. For details, see [Track changes for users\nand shared drives](/workspace/drive/api/guides/about-changes).\n\nRelated topics\n--------------\n\n- [Files and folders overview](/workspace/drive/api/guides/about-files)\n- [Changes and revisions overview](/workspace/drive/api/guides/change-overview)"]]
