Compatibilité avec les Drive partagés

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:

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 sont user, domain, drive et allDrives. Pour plus d'efficacité, préférez user ou drive à 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.