Les Drive partagés s'appuient sur des règles d'organisation, de partage et de propriété différentes dans Mon Drive. Si votre application doit créer et gérer des fichiers sur des fichiers partagés vous devez assurer la compatibilité avec les 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 listées ci-dessous:
API Drive version 3
files.getfiles.listfiles.createfiles.updatefiles.copyfiles.deletechanges.listchanges.getStartPageTokenpermissions.listpermissions.getpermissions.createpermissions.updatepermissions.delete
API Drive version 2
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 informe Google Drive que
est conçue pour gérer les fichiers des 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 de Drive partagés supplémentaires. Le reste de ce document met en évidence les modifications supplémentaires requises pour ces tâches.
Rechercher du contenu dans un Drive partagé
Utilisez la méthode files.list pour rechercher
Drive partagés. Cette section traite des champs spécifiques aux Drive partagés dans le
files.list. Pour rechercher un Drive partagé, consultez
Recherchez des fichiers et des dossiers.
La méthode files.list contient les éléments partagés suivants :
champs spécifiques à Drive et modes de requête:
driveId: ID du Drive partagé à rechercher.includeItemsFromAllDrives: indique si les éléments des Drive partagés doivent être inclus dans les résultats. S'il n'est pas présent ou s'il est défini sur "False", les éléments des Drive partagés ne sont pas renvoyées.corpora: corps des éléments (fichiers/documents) auxquels auquel la requête s'applique. Les corps compatibles sontuser,domain,driveetallDrives. Pour plus d'efficacité, préférezuseroudriveàallDrives.supportsAllDrives: indique si l'application à l'origine de la demande est compatible avec à la fois dans Mon Drive et dans les Drive partagés. Si la valeur est "false", cela signifie que les éléments des Drive partagés incluses 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 Drive partagés et Mon Drive. |
true |
drive |
Interroge tous les éléments du Drive partagé spécifié. driveId doit être spécifié dans la demande. |
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 fait l'objet de recherches pour cette requête. |
true |
domain |
Interroge les fichiers partagés au sein du domaine, y compris les fichiers Drive partagés et Mon Drive. |
Suivre les modifications apportées à un Drive partagé
Utiliser la méthode changes.list pour suivre les modifications
sur un Drive partagé. Cette section traite des champs spécifiques aux Drive partagés dans le
changes.list. Pour en savoir plus, consultez
Suivre les modifications pour les utilisateurs et les Drive partagés
La méthode changes.list contient les éléments partagés suivants :
champs spécifiques à Drive et modes de requête:
driveId: Drive partagé à partir duquel les modifications sont renvoyées Si spécifié, les ID de modification font référence aux modifications apportées au Drive partagé, et non les modifications apportées aux fichiers qui sont présentés à l'utilisateur. Pour faire référence à un Drive partagé spécifique l'ID du Drive partagé et l'ID de modification doivent être utilisés comme identifiants.supportsAllDrives: indique si l'application à l'origine de la demande est compatible avec le partage de votre disque. Si la valeur est "false", les éléments des Drive partagés, y compris les Drive partagés et fichiers d'un Drive partagé, ne sont pas renvoyés.includeItemsFromAllDrives: indique si les fichiers des Drive partagés ou les modifications doivent être incluses 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 | Ces 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 changements apportés aux Drive partagés dont l'utilisateur est membre. |
true |
Oui | Elles 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 Journaux des modifications
Activer la compatibilité avec les Drive partagés dans l'interface utilisateur de Drive
Pour accéder au contenu d'un Drive partagé à l'aide de l'interface utilisateur de Drive, assurez-vous d'avoir coché les "Compatibilité avec les Drive partagés" dans Console Google APIs Pour en savoir plus, consultez Configurer l'intégration de l'interface utilisateur Drive
Utiliser le sélecteur de fichier avec les Drive partagés
Le sélecteur de fichier permet de sélectionner des éléments dans les Drive partagés. Pour en savoir plus sur l'activation de la compatibilité avec les Drive partagés et l'ajout de la vue des Drive partagés Dans le sélecteur de fichier, consultez la page API Google Picker.
Étapes suivantes
Passez à la section Gérer les Drive partagés de sur la création de Drive partagés et la gestion des autorisations associées.