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

Où :

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

  • 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 opérateurs de requête que vous pouvez utiliser pour filtrer les Drives 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 répertorie des exemples de chaînes de requête de base pour les lecteurs 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 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 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
Drive partagés contenant le mot "confidentiel" dans leur titre, 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 ne contenant 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 les Drives partagés créés après une date spécifique et qui comptent plus de cinq administrateurs 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 administrateurs 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.