Différences entre les Drive partagés et l'API My Drive
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les Drive partagés suivent des modèles d'organisation, de partage et de propriété différents de ceux de Mon Drive. Par conséquent, certaines opérations Mon Drive ne sont pas autorisées pour le contenu d'un Drive partagé.
Ce guide décrit les différences spécifiques aux API pour les ressources files et changes dans les lecteurs partagés.
Ressource de fichier
Les champs suivants de la ressource files ne sont renseignés que pour les fichiers situés dans un Drive partagé :
hasAugmentedPermissions : indique si des utilisateurs ont accès au fichier directement.capabilities/canAddFolderFromAnotherDrive : indique si l'utilisateur actuel peut ajouter un dossier d'un autre Drive (un autre Drive partagé ou Mon Drive) à ce dossier.capabilities/canDeleteChildren : indique si l'utilisateur actuel peut supprimer les enfants de ce dossier.capabilities/canMoveChildrenOutOfDrive : indique si l'utilisateur actuel peut déplacer les enfants de ce dossier en dehors du Drive partagé.capabilities/canMoveChildrenWithinDrive : indique si l'utilisateur actuel peut déplacer les enfants de ce dossier dans le Drive partagé.capabilities/canMoveItemWithinDrive : indique si l'utilisateur actuel peut déplacer cet élément de Drive partagé dans le Drive partagé.capabilities/canReadDrive : indique si l'utilisateur actuel dispose d'un accès en lecture au lecteur partagé auquel appartient ce fichier.capabilities/canTrashChildren : indique si l'utilisateur actuel peut placer dans la corbeille les éléments enfants de ce dossier.driveId : ID du lecteur partagé dans lequel se trouve le fichier.trashingUser : si le fichier a été explicitement placé dans la corbeille, l'utilisateur qui l'a placé dans la corbeille.trashedTime : heure à laquelle l'élément a été placé dans la corbeille. Si vous utilisez l'ancienne API Drive v2, ce champ est appelé trashedDate.
Les champs suivants ne sont pas renseignés pour les fichiers situés dans un Drive partagé :
permissions : en raison de la taille potentielle des listes de contrôle d'accès (LCA) des Drive partagés, les autorisations ne sont pas renvoyées dans les fichiers. Utilisez la méthode permissions.list, qui prend en charge la pagination, pour lister les autorisations d'accès à un fichier dans un Drive partagé ou au dossier du Drive partagé.owners, ownerNames, ownedByMe : les fichiers d'un Drive partagé appartiennent au Drive partagé, et non à des utilisateurs individuels.folderColorRgb : Vous ne pouvez pas attribuer de couleur à des dossiers individuels.shared : tous les éléments d'un Drive partagé sont partagés.writersCanShare : il n'est pas possible de limiter le partage par rôle dans les Drive partagés.
Les champs suivants ne sont définis que lorsque l'utilisateur a reçu des autorisations d'accès aux fichiers pour un élément :
sharedWithMeDatesharingUser
Les champs suivants nécessitent une attention particulière lorsque vous les utilisez avec des lecteurs partagés :
parents.isRoot : ce champ n'est défini sur "true" que pour le dossier racine "Mon Drive". Il est défini sur "false" pour le dossier de premier niveau du Drive partagé.parents : un parent n'apparaît pas dans la liste des parents si l'utilisateur qui envoie la demande n'est pas membre du Drive partagé et n'a pas accès au parent. De plus, à l'exception du dossier de premier niveau, la liste des parents doit contenir exactement un élément si le fichier se trouve dans un Drive partagé.
capabilities/canRemoveChildren : utilisez capabilities/canDeleteChildren ou capabilities/canTrashChildren.
Modifier une ressource
Les nouveaux champs suivants sont disponibles dans la ressource changes pour un Drive partagé :
changeType : type de modification. Les valeurs possibles sont file et drive.driveId : ID du lecteur partagé associé à cette modification.drive : état mis à jour du lecteur partagé. Présent si changeType est défini sur drive et que l'utilisateur est toujours membre du Drive partagé.
Des modifications supplémentaires peuvent être nécessaires pour les applications qui doivent synchroniser du contenu avec des lecteurs partagés ou suivre l'activité. Pour en savoir plus, consultez Suivre les modifications apportées par les utilisateurs et les Drive partagés.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)"]]
