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 de Drive partagé 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 informe Google Drive que votre application 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 présente 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 disques partagés. Cette section couvre les champs spécifiques aux Drive 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é à rechercher.includeItemsFromAllDrives: indique si les éléments des Drive partagés doivent être inclus dans les résultats. Si elle n'est pas présente ou définie sur "false", les éléments Drive partagés ne sont pas renvoyés.corpora: corps des éléments (fichiers/documents) auxquels s'applique la requête. Les corps compatibles sontuser,domain,driveetallDrives. Pour plus d'efficacité, privilégiezuseroudriveàallDrives.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 Drive partagés et Mon Drive. |
true |
drive |
Interroge tous les éléments du Drive partagé spécifié. L'ID de drive 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 apportées à un Drive partagé
Utilisez la méthode changes.list pour suivre les modifications apportées à un Drive partagé. Cette section couvre les champs spécifiques aux Drive partagés dans la méthode changes.list. Pour en savoir plus, consultez Suivre les modifications apportées par les utilisateurs et les Drive partagés.
La méthode changes.list contient les champs et modes de requête suivants spécifiques aux Drive partagés:
driveId: Drive partagé à partir duquel les modifications sont renvoyées. Le cas échéant, les ID de modification font référence aux modifications apportées au Drive partagé, et non aux modifications apportées aux fichiers présentés à l'utilisateur. Pour faire référence à une modification de Drive partagé spécifique, 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 Drive partagés, y compris les Drive partagés et les fichiers d'un Drive partagé, ne sont pas renvoyés.includeItemsFromAllDrives: indique si les fichiers ou les modifications de 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 les modifications apportées aux fichiers dans ou en dehors 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 la page Journaux des modifications.
Activer la compatibilité avec les Drive partagés dans l'interface utilisateur de Drive
Pour accéder au contenu de Drive partagé à l'aide de l'interface utilisateur de Drive, assurez-vous d'avoir activé l'option "Compatibilité avec les 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 fichier avec les Drive partagés
Le sélecteur de fichiers permet de sélectionner des éléments dans des Drive partagés. Pour en savoir plus sur l'activation de la compatibilité avec les Drive partagés et l'ajout de la vue Drive partagé dans le sélecteur de fichiers, consultez l'API Google Picker.
Étapes suivantes
Pour savoir comment créer et gérer des Drive partagés, consultez Gérer les Drive partagés.