Rechercher des Drive partagés

Ce guide explique comment l'API Google Drive permet de rechercher des Drive partagés de plusieurs manières.

Pour rechercher un ensemble spécifique de Drive partagés, utilisez le champ de chaîne de requête q field avec la list méthode sur la ressource drives afin de filtrer les Drive à renvoyer en combinant un ou plusieurs termes de recherche.

Une chaîne de requête contient les trois parties suivantes :

query_term operator values

Signification :

  • query_term correspond au terme ou au champ de requête à rechercher.

  • operator spécifie la condition appliquée au terme de requête.

  • values correspondent aux valeurs spécifiques que vous souhaitez utiliser pour filtrer les résultats de votre recherche.

Par exemple, la chaîne de requête suivante filtre la recherche pour ne renvoyer que les Drive partagés portant le nom "API Google Drive resources".

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

Pour afficher tous les termes de requête des Drive partagés, consultez Termes de requête spécifiques aux Drive partagés.

Pour afficher tous les opérateurs de requête que vous pouvez utiliser pour créer une requête, consultez Opérateurs derequête.

Exemples de chaînes de requête

Le tableau suivant présente des exemples de chaînes de requête de base pour les Drive partagés. Le code exact varie selon la bibliothèque cliente que vous utilisez pour votre recherche.

Vous devez également échapper les caractères spéciaux dans les noms de fichiers pour que la requête fonctionne correctement. Par exemple, si un nom de fichier contient à la fois une apostrophe (') et une barre oblique inverse ("\"), utilisez une barre oblique inverse pour les échapper : name contains 'quinn\'s paper\\essay'.

Éléments à interroger Exemple Paramètre useDomainAdminAccess
Opérateur de correspondance de chaîne (contains)
Tous les Drive partagés dont l'utilisateur est membre et dont le titre contient le mot "confidentiel" name contains 'confidential' false
Opérateurs d'égalité et d'inégalité (=, !=)
Drive partagés visibles dans la vue par défaut hidden = false false
Drive partagés masqués dans la vue par défaut hidden = true false
Drive partagés sans organisateur attribué organizerCount = 0 true
Drive partagés avec exactement un membre memberCount = 1 true
Drive partagés appartenant à l'ID d'unité organisationnelle orgUnitId = 'C03az79cb' true
Drive partagés ne contenant pas l'ID d'unité organisationnelle orgUnitId != 'C03az79cb' true
Drive partagés dont le nom ne correspond pas à un nom spécifique name != 'Archived Projects' true
Opérateurs de comparaison (>, >=, <, <=)
Drive partagés créés après le 1er juin 2017 createdTime > '2017-06-01T12:00:00' true
Drive partagés créés avant le 1er janvier 2023 createdTime < '2023-01-01T00:00:00' true
Drive partagés avec plus d'un membre memberCount > 1 true
Drive partagés avec moins de cinq membres memberCount < 5 true
Drive partagés avec trois organisateurs ou moins organizerCount <= 3 true
Opérateurs logiques (and, or, not)
Drive partagés dont le titre contient le mot "confidentiel" et qui comptent 20 membres ou plus name contains 'confidential' and memberCount >= 20 true
Tous les Drive partagés de l'organisation dont le titre contient le mot "confidentiel" name contains 'confidential' and orgUnitId = 'C03az79cb' true
Drive partagés dont le nom contient "Projet" ou "Archive" name contains 'Project' or name contains 'Archive' true
Drive partagés dont le nom ne contient pas "Brouillon" not name contains 'Draft' true
Drive partagés n'appartenant pas à une unité organisationnelle cible et créés après une date spécifique orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

Combiner plusieurs termes de requête avec des parenthèses

Vous pouvez utiliser des parenthèses pour regrouper plusieurs termes de requête. Par exemple, pour rechercher les Drive partagés créés après une date spécifique et qui comptent plus de cinq organisateurs ou plus de 20 membres, utilisez la requête suivante :

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

Cette recherche renvoie tous les Drive partagés créés après le 1er janvier 2019 et qui comptent plus de cinq organisateurs ou plus de 20 membres.

L'API Drive évalue les opérateurs and et or de gauche à droite. Par conséquent, la même recherche sans parenthèses renverrait les éléments suivants :

  • seuls les Drive partagés créés après le 1er janvier 2019 et comptant plus de cinq organisateurs ;
  • tous les Drive partagés comptant plus de 20 membres, même ceux créés avant le 1er janvier 2019.