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 contient les trois parties suivantes :

query_term operator values

Signification :

  • query_term correspond au terme ou au champ de requête sur lequel effectuer la recherche.

  • operator spécifie la condition appliquée au 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 de requête et opérateurs 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 "Google Drive API resources".

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ê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'.

Critère de recherche Exemple Paramètre useDomainAdminAccess
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
Drive partagés dont le titre contient le mot "confidentiel" et qui comptent au moins 20 membres 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
Tous les Drive partagés dont l'utilisateur est membre et dont le titre contient le mot "confidentiel" name contains 'confidential' false
Drive partagés sans organisateur attribué organizerCount = 0 true
Drive partagés ne contenant pas l'ID de l'unité organisationnelle orgUnitId != 'C03az79cb' 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. La même recherche sans parenthèses renverrait donc :

  • 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.