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 Drives partagés, vous devez implémenter la prise en charge des Drives 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 listées ci-dessous :
API Drive v3
files.getfiles.listfiles.createfiles.updatefiles.copyfiles.deletechanges.listchanges.getStartPageTokenpermissions.listpermissions.getpermissions.createpermissions.updatepermissions.delete
API Drive v2
files.getfiles.listfiles.insertfiles.updatefiles.patchfiles.copyfiles.trashfiles.untrashfiles.deletefiles.touchchildren.insertparents.insertchanges.listchanges.getStartPageTokenchanges.getpermissions.listpermissions.getpermissions.insertpermissions.updatepermissions.patchpermissions.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 doivent effectuer des recherches dans plusieurs corpus nécessitent des fonctionnalités supplémentaires de Drive partagé. 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 files.list pour rechercher des lecteurs partagés. Cette section traite des champs spécifiques aux Drives partagés dans la méthode files.list. Pour rechercher un Drive partagé, consultez Rechercher des fichiers et des dossiers.
La méthode files.list contient les champs et modes de requête spécifiques aux lecteurs partagés suivants :
driveId: ID du Drive partagé dans lequel effectuer la recherche.includeItemsFromAllDrives: indique si les éléments des Drive partagés doivent être inclus dans les résultats. Si la valeur est "false" ou n'est pas définie, les éléments des lecteurs partagés ne sont pas renvoyés.corpora: corps des éléments (fichiers/documents) auxquels s'applique la requête. Les corps acceptés sontuser,domain,driveetallDrives. PréférezuseroudriveàallDrivespour l'efficacité.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é 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 |
drive |
Interroge tous les éléments du Drive partagé spécifié. 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. |
true |
domain |
Interroge les fichiers partagés avec le domaine, y compris les fichiers Drive partagés et Mon Drive. |
Suivre les modifications dans un Drive partagé
Utilisez la méthode changes.list pour suivre les modifications apportées à un Drive partagé. Cette section traite des champs spécifiques aux Drives partagés dans la méthode changes.list. Pour en savoir plus, consultez Suivre les modifications apportées par les utilisateurs et dans les Drive partagés.
La méthode changes.list contient les champs et modes de requête spécifiques aux lecteurs partagés suivants :
driveId: Drive partagé à partir duquel les modifications sont renvoyées. S'ils sont spécifiés, les ID de modification font référence aux modifications apportées au Drive partagé, et non aux modifications apportées aux fichiers affichés pour l'utilisateur. Pour faire référence à une modification spécifique d'un Drive partagé, vous devez utiliser à la fois l'ID du Drive partagé et l'ID de la modification comme identifiant.supportsAllDrives: indique si l'application à l'origine de 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.includeItemsFromAllDrives: indique si les fichiers ou les modifications apportées aux Drive partagés doivent être inclus dans la liste des modifications.
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 Journaux des modifications.
Activer la compatibilité avec les Drive partagés dans l'interface utilisateur de Drive
Pour accéder au contenu des Drive partagés à l'aide de l'interface utilisateur Drive, assurez-vous d'avoir coché l'option "Prise en charge des Drive partagés" dans la console Google API. Pour en savoir plus, consultez Configurer une intégration de l'UI Drive.
Utiliser le sélecteur de fichiers avec les Drive partagés
Le sélecteur de fichiers 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 la vue des Drive partagés dans le sélecteur de fichiers, consultez l'API Google Picker.
Étapes suivantes
Consultez Gérer les Drive partagés pour obtenir de l'aide sur la création de Drive partagés et la gestion de leurs autorisations.