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 document décrit les différences entre les API spécifiques aux lecteurs partagés.
Ressource de fichier
Les champs suivants de la ressource File
ne sont renseignés que pour les fichiers situés dans un Drive partagé:
hasAugmentedPermissions
: indique si des utilisateurs sont autorisés à accéder directement à ce fichier.capabilities/canAddFolderFromAnotherDrive
: indique si l'utilisateur actuel peut ajouter un dossier à partir d'un autre Drive (un autre Drive partagé ou Mon Drive).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 mettre les enfants de ce dossier à la corbeille.driveId
: ID du disque partagé dans lequel se trouve le fichier.trashingUser
: si le fichier a été explicitement placé dans la corbeille, l'utilisateur qui l'a fait.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 LCA de Drive partagé, les autorisations ne sont pas renvoyées dans les fichiers. Utilisez la méthodepermissions.list()
, qui prend en charge la pagination, pour lister les autorisations d'un fichier dans un Drive partagé ou dans le 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 colorer individuellement les dossiers.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:
sharedWithMeDate
sharingUser
Les champs suivants doivent être pris en compte avec soin lorsque vous les utilisez avec des disques partagés:
parents.isRoot
: ce champ n'est vrai que pour le dossier racine de Mon Drive. Il est faux pour le dossier de premier niveau du Drive partagé.parents
: un parent n'apparaît pas dans la liste des parents si l'utilisateur à l'origine de 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 disque partagé.capabilities/canRemoveChildren
: utilisezcapabilities/canDeleteChildren
oucapabilities/canTrashChildren
.
Ressource d'autorisation
Le champ permissionDetails
de la ressource Permission
n'est renseigné que pour les fichiers situés dans un Drive partagé. Ce champ est une liste condensée des autorisations activées ou héritées par ce fichier Drive partagé. Ce champ est un champ de sortie uniquement et n'est présent que pour les éléments Drive partagés. De plus :
- Deux nouveaux rôles,
organizer
etfileOrganizer
, ont été définis. - La méthode
permissions.list()
permet la pagination.
Modifier une ressource
Les nouveaux champs suivants sont disponibles dans la ressource Change
pour un Drive partagé:
changeType
: type de modification. Les valeurs possibles sontfile
etdrive
.driveId
: ID du disque partagé associé à cette modification.drive
: état mis à jour du disque partagé. Présent sichangeType
estdrive
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 disques partagés ou suivre l'activité. Pour en savoir plus, consultez Suivre les modifications apportées aux utilisateurs et aux Drive partagés.