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 dans 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 informe Google Drive que votre application est conçue pour gérer les fichiers dans les Drive partagés.

Les applications qui lisent ou modifient des 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 modifications supplémentaires requises 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 Drive partagé à rechercher.

  • corpora : corps des éléments (fichiers ou documents) auxquels la requête s'applique. Les corps acceptés sont user, domain, drive et allDrives. Pour plus d'efficacité, préférez user ou drive à allDrives. Par défaut, le corpus est défini sur user.

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

  • supportsAllDrives: indique si l'application qui effectue la requête est compatible avec Mon Drive et les Drive partagés. Si la valeur est "false", les éléments des 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 des Drive partagés et de 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 dans un Drive partagé. Pour en savoir plus, consultez Suivre les modifications pour les utilisateurs et les Drive 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 elle est spécifiée, les ID de modification 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 modification doivent être utilisés comme identifiant.

  • 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 requête 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 les modifications apportées aux fichiers à l'intérieur ou à l'extérieur des Drive partagés auxquels l'utilisateur a accédé, ainsi que les modifications apportées aux Drive partagés dont l'utilisateur est membre.
true Oui Les modifications reflètent les modifications 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 pour les utilisateurs et les Drive partagés.

Activer la prise en charge des Drive partagés dans l'UI Drive

Pour accéder au contenu des Drive partagés à l'aide de l'UI Drive, assurez-vous d' avoir coché la case Prise en charge des Drive 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 Google Picker avec les Drive partagés

Le Google Picker permet de sélectionner des éléments dans les Drive partagés. Pour en savoir plus sur l'activation de la prise en charge des Drive partagés et l'ajout de vues de Drive partagés dans le sélecteur, consultez l'API Google Picker.