Rechercher des Drive partagés

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

Une chaîne de requête se compose des trois parties suivantes:

query_term operator values

Où :

  • query_term est le terme ou le champ de requête à rechercher.

  • operator spécifie la condition du terme de requête.

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

Pour afficher les termes et opérateurs de requête que vous pouvez utiliser pour filtrer les Drive partagés, consultez Termes et opérateurs de requête de recherche.

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

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

Exemples de chaînes de requête

Le tableau suivant répertorie des exemples de chaînes de requête de base pour les Drive partagés. Le code réel varie en fonction de 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 vous assurer 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'.

Ce que vous souhaitez interroger Exemple useDomainAdminAccess paramètre
Drive partagés créés après le 1er juin 2017 createdTime > '2017-06-01T12:00:00' true
Drive partagés visibles dans la vue par défaut hidden = false false
Drive partagés comportant plusieurs membres memberCount > 1 true
Drive partagés dont le titre contient le mot "confidentiel" et comportant au moins 20 membres name contains 'confidential' and memberCount >= 20 true
Drive partagés dont le titre contient la mention "confidentiel" parmi tous les Drive partagés de l'organisation name contains 'confidential' and orgUnitId = 'C03az79cb' true
Drive partagés dont le titre contient le mot "confidentiel" parmi tous les Drive partagés dont l'utilisateur est membre name contains 'confidential' false
Drive partagés sans organisateur attribué organizerCount = 0 true
Drive partagés dont l'ID d'unité organisationnelle n'est pas renseigné orgUnitId != 'C03az79cb' true

Interroger plusieurs termes avec des parenthèses

Vous pouvez utiliser des parenthèses pour regrouper plusieurs termes de requête. Par exemple, pour rechercher des Drive partagés créés après une date spécifique et comptant 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 comportant 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 renvoie:

  • Uniquement les Drive partagés avec plus de cinq organisateurs créés après le 1er janvier 2019.
  • Tous les Drive partagés comptant plus de 20 membres, y compris ceux créés avant le 1er janvier 2019