Différences entre les Drive partagés et l'API My Drive

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 de Mon Drive ne sont pas autorisées pour le contenu d'un Drive partagé.

Ce guide décrit les différences spécifiques aux Drive partagés dans les ressources files et changes de l'API.

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 bénéficient d'un accès direct à ce fichier.
  • 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 des enfants de ce dossier.
  • capabilities/canMoveChildrenOutOfDrive: indique si l'utilisateur actuel peut déplacer des enfants de ce dossier en dehors du Drive partagé.
  • capabilities/canMoveChildrenWithinDrive: indique si l'utilisateur actuel peut déplacer des 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 Drive partagé auquel appartient ce fichier.
  • capabilities/canTrashChildren: indique si l'utilisateur actuel peut mettre à la corbeille des enfants de ce dossier.
  • driveId : ID du Drive partagé dans lequel se trouve le fichier.
  • trashingUser: si le fichier a été mis à la corbeille de manière explicite, l'utilisateur qui l'a mis à la corbeille.
  • trashedTime : heure à laquelle l'élément a été mis à 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'un fichier dans un Drive partagé ou le dossier du Drive partagé.
  • owners, ownerNames, ownedByMe : les fichiers d'un Drive partagé appartiennent au Drive partagé, et non à des utilisateurs individuels.
  • folderColorRgb : les dossiers ne peuvent pas être colorés individuellement.
  • 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 à un élément :

  • sharedWithMeDate
  • sharingUser

Les champs suivants nécessitent une attention particulière lorsque vous les utilisez avec des Drive 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 demandeur 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 ne doit contenir qu'un seul élément si le fichier se trouve dans un Drive partagé.

  • capabilities/canRemoveChildren: utilisez capabilities/canDeleteChildren ou capabilities/canTrashChildren.

Ressource de modification

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 Drive partagé associé à cette modification.
  • drive : état mis à jour du Drive partagé. Présent si le changeType est 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 Drive partagés ou suivre l'activité. Pour en savoir plus, consultez Suivre les modifications pour les utilisateurs et les Drive partagés.