Les Drive partagés suivent différents modèles d'organisation, de partage et de propriété provenant de Mon Drive. Si votre application doit créer et gérer des fichiers sur des Drive partagés, vous devez intégrer les Drive partagés. La complexité de l'implémentation dépend des fonctionnalités de votre application.
Pour commencer, vous devez inclure le paramètre supportsAllDrives=true dans vos requêtes lorsque votre application effectue les opérations répertorié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 supplémentaires pour les Drive partagés. 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 Drive partagés. Cette section traite des 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 suivants spécifiques au Drive partagé:
driveId: ID du Drive partagé dans lequel effectuer la recherche.includeItemsFromAllDrives: indique si des éléments de Drive partagés doivent être inclus dans les résultats. S'il est absent ou s'il est défini sur "false", les éléments de Drive partagés ne sont pas renvoyés.corpora: corps d'éléments (fichiers/documents) auxquels s'applique la requête. Les corps acceptés sontuser,domain,driveetallDrives. Pour plus d'efficacité, privilégiezuseroudriveàallDrives.supportsAllDrives: indique si l'application à l'origine de la demande est compatible avec Mon Drive et les Drive partagés. Si la valeur est "false", les éléments du 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 Mon Drive. |
true |
drive |
Interroge tous les éléments du Drive partagé spécifié. Le DriveId doit être spécifié dans la demande. |
true |
allDrives |
Interroge les fichiers auxquels l'utilisateur a accès 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 au sein du domaine, y compris les fichiers des Drive partagés et des fichiers Mon Drive. |
Suivre les modifications sur un Drive partagé
Utilisez 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 la méthode 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 champs et modes de requête suivants spécifiques au Drive partagé:
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 présentés à l'utilisateur. Pour faire référence à une modification de Drive partagé spécifique, l'ID du Drive partagé et l'ID de modification doivent être utilisés comme identifiant.supportsAllDrives: indique si l'application à l'origine de la demande est compatible avec les Drive partagés. Si la valeur est "false", les éléments d'un Drive partagé, y compris les Drive partagés et les fichiers qu'il contient, ne sont pas renvoyés.includeItemsFromAllDrives: indique si les fichiers de Drive partagés ou les modifications 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 situés à l'intérieur ou à l'extérieur des Drive partagés auxquels l'utilisateur a accédé, ainsi que celles apportées aux Drive partagés dont il est membre. |
true |
Oui | Celles-ci 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 l'article 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 de Drive, assurez-vous d'avoir coché la case "Compatibilité des Drive partagés" dans la console Google APIs. Pour en savoir plus, consultez Configurer l'intégration d'une interface utilisateur Drive.
Utiliser le sélecteur de fichier avec des Drive partagés
Le sélecteur de fichier permet de sélectionner des éléments dans des Drive partagés. Pour en savoir plus sur l'activation de la prise en charge des Drive partagés et l'ajout d'une vue de Drive partagés dans le sélecteur de fichier, reportez-vous à l'API Google Picker.
Étapes suivantes
Passez à la section 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.