Compatibilité avec les Drive partagés

Les Drive partagés suivent des modèles d'organisation, de partage et de propriété différents de ceux de Mon Drive. Si votre application doit créer et gérer des fichiers sur des Drive partagés, vous devez implémenter la prise en charge des Drive partagés dans votre application. La complexité de votre implémentation dépend des fonctionnalités de votre application.

Pour commencer, vous devez inclure le paramètre de requête supportsAllDrives=true dans vos requêtes lorsque votre application effectue les opérations suivantes :

API Drive v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

API Drive v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

Le paramètre supportsAllDrives=true indique à Google Drive que votre application est conçue pour gérer les fichiers sur les Drive partagés.

Les applications qui lisent ou modifient les autorisations, suivent les modifications ou effectuent des recherches dans plusieurs corpus nécessitent des fonctionnalités supplémentaires pour les Drive partagés. Le reste de ce document met en évidence les autres modifications nécessaires pour effectuer ces tâches.

Rechercher du contenu dans un Drive partagé

Utilisez la méthode list sur la ressource files pour trouver les fichiers utilisateur dans les Drive partagés. Pour rechercher un Drive partagé, consultez Rechercher des Drive partagés.

La méthode list contient les paramètres de requête spécifiques aux Drive partagés suivants :

  • driveId : ID du lecteur partagé à rechercher.

  • corpora : corps des éléments (fichiers ou documents) auxquels s'applique la requête. Les corps acceptés sont user, domain, drive et allDrives. Privilégiez user ou drive à allDrives pour l'efficacité. Par défaut, les corpus sont définis sur user.

  • includeItemsFromAllDrives : indique si les éléments de Mon Drive et des Drive partagés doivent être inclus dans les résultats. Si cette valeur n'est pas présente ou est définie sur "false", les éléments de Drive partagé ne sont pas renvoyés.

  • supportsAllDrives : indique si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés. Si la valeur est "false", les éléments de Drive partagés ne sont pas inclus dans la réponse.

Les modes de requête suivants sont spécifiques aux Drive partagés :

includeItemsFromAllDrives corpora Description de la requête
true user Interroge les fichiers auxquels l'utilisateur a accédé, y compris les fichiers des Drive partagés et de Mon Drive.
true domain Interroge les fichiers partagés avec le domaine, y compris les fichiers Drive partagés et Mon Drive.
true drive Interroge tous les éléments du Drive partagé spécifié. Le driveId doit être spécifié dans la requête.
true allDrives Interroge les fichiers auxquels l'utilisateur a accédé et tous les Drive partagés dont il est membre. Notez que la réponse peut inclure incompleteSearch:true, ce qui indique que certains corpus n'ont pas été recherchés pour cette requête.

Suivre les modifications dans un Drive partagé

Utilisez la méthode list sur la ressource changes pour suivre les modifications apportées à un Drive partagé. Pour en savoir plus, consultez Suivre les modifications apportées par les utilisateurs et les lecteurs partagés.

La méthode list contient les paramètres de requête spécifiques aux Drive partagés suivants :

  • driveId : Drive partagé à partir duquel les modifications sont renvoyées. Si des ID de modification sont spécifiés, ils font référence aux modifications apportées aux éléments du Drive partagé, ce qui fournit l'état actuel d'un fichier. Pour faire référence à une modification spécifique d'un Drive partagé, l'ID du Drive partagé et l'ID de la modification doivent être utilisés comme identifiants.

  • includeItemsFromAllDrives : indique si les fichiers ou les modifications des Drive partagés doivent être inclus dans la liste des modifications.

  • supportsAllDrives : indique si l'application qui effectue la demande est compatible avec les Drive partagés. Si la valeur est "false", les éléments des Drive partagés (y compris les Drive partagés et les fichiers qu'ils contiennent) ne sont pas renvoyés.

Les modes de requête suivants sont spécifiques aux Drive partagés :

includeItemsFromAllDrives driveId Description de la requête
true Non Les modifications reflètent celles apportées aux fichiers à l'intérieur ou à l'extérieur des Drive partagés auxquels l'utilisateur a accédé, ainsi qu'aux Drive partagés dont il est membre.
true Oui Les modifications reflètent celles apportées au Drive partagé spécifié et aux éléments qu'il contient.

Pour en savoir plus sur le comportement du journal des modifications, consultez Suivre les modifications apportées par les utilisateurs et les Drive partagés.

Activer la compatibilité avec les Drive partagés dans l'interface utilisateur de Drive

Pour accéder au contenu des lecteurs partagés à l'aide de l'interface utilisateur Drive, assurez-vous d'avoir coché la case Prise en charge des lecteurs partagés dans l'onglet Intégration de l'UI Drive de l'API Google Drive dans la console Google Cloud. Pour en savoir plus, consultez Configurer une intégration de l'UI Drive.

Utiliser le sélecteur Google avec des Drive partagés

Le sélecteur Google permet de sélectionner des éléments dans les Drive partagés. Pour savoir comment activer la compatibilité avec les Drive partagés et ajouter des vues de Drive partagés dans le sélecteur, consultez l'API Google Picker.