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

Les Drive partagés suivent différents modèles d'organisation, de partage et de propriété depuis un dossier Mon Drive. Par conséquent, certaines opérations Mon Drive ne sont pas autorisées sur le contenu d'un Drive partagé. Ce document décrit les différences d'API propres aux Drive partagés.

Ressource Files

Les champs suivants ne sont renseignés que pour les fichiers situés dans un Drive partagé:

  • hasAugmentedPermissions : indique si des utilisateurs disposent d'un accès direct à ce fichier.
  • capabilities/canAddFolderFromAnotherDrive : indique si l'utilisateur actuel peut ajouter à ce dossier un dossier d'un autre Drive (Drive partagé ou Mon Drive différent).
  • 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 hors 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é vers le Drive partagé.
  • capabilities/canReadDrive : indique si l'utilisateur actuel dispose d'un accès en lecture au Drive partagé auquel ce fichier appartient.
  • capabilities/canTrashChildren : indique si l'utilisateur actuel peut placer les enfants de ce dossier dans la corbeille.
  • driveId : ID du Drive 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.

Les champs suivants ne sont pas renseignés pour les fichiers d'un Drive partagé:

  • permissions : en raison de la taille potentielle des 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, afin de répertorier les autorisations d'un fichier dans un Drive partagé ou sur le Drive partagé lui-même.
  • owners, ownerNames, ownedByMe : les fichiers d'un Drive partagé appartiennent à celui-ci, 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 est actuellement impossible de restreindre 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 d'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 : la valeur de ce champ est "false" uniquement pour le dossier racine de Mon Drive et "false" pour le dossier racine 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 Drive partagé.

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

Ressource Permissions

Le champ permissionDetails n'est renseigné que pour les fichiers situés dans un Drive partagé. Ce champ contient la liste des autorisations condensées activées ou héritées par ce fichier de Drive partagé. Ce champ est en sortie uniquement et n'est présent que pour les éléments de Drive partagés. De plus :

  • deux nouveaux rôles organizer et fileOrganizer ont été définis.
  • Mise à jour de permissions.list, qui accepte désormais la pagination.

Ressource Changes

Les nouveaux champs suivants sont disponibles dans la ressource Changes d'un Drive partagé:

  • changeType : type de modification. Les valeurs possibles sont file et drive.
  • driveId : ID du Drive partagé associé à la modification.
  • drive : état mis à jour du Drive partagé. Présent si changeType est défini sur drive et que l'utilisateur est toujours membre du Drive partagé.

D'autres modifications 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.