Rechercher des Drive partagés

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

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

query_term operator values

Où :

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

  • operator spécifie la condition pour le 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 les 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 lecteurs 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 présente des exemples de chaînes de requêtes de base pour les disques partagés. Le code réel diffère 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 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'.

Éléments interrogés 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 avec plusieurs membres memberCount > 1 true
Drives partagés avec le mot "confidentiel" dans le titre et comptant 20 membres ou plus name contains 'confidential' and memberCount >= 20 true
Drive partagés contenant le mot "confidentiel" dans le titre parmi tous les Drive partagés de l'organisation name contains 'confidential' and orgUnitId = 'C03az79cb' true
Drives partagés contenant le mot "confidentiel" dans le titre 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 qui ne contiennent pas l'ID de l'unité organisationnelle 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 comportant plus de cinq organisateurs ou plus de 20 membres, utilisez cette requête:

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 renvoie:

  • Seuls 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, même ceux créés avant le 1er janvier 2019.