Termes de requête et opérateurs de recherche

Ce guide de référence fournit des termes et des opérateurs de requête que vous pouvez utiliser avec l'API Google Drive pour filtrer les fichiers, les dossiers et les lecteurs partagés.

Pour obtenir des exemples de recherche de fichiers, consultez Rechercher des fichiers et des dossiers.

Pour obtenir des exemples de recherches de Drive partagés, consultez Rechercher des Drive partagés.

Syntaxe de la chaîne de requête

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.

Opérateurs de requêtes

Le tableau suivant répertorie les opérateurs de requête valides :

Opérateur Utilisation
contains Le contenu d'une chaîne est présent dans l'autre.
= Le contenu d'une chaîne ou d'un booléen est égal à l'autre.
!= Le contenu d'une chaîne ou d'une valeur booléenne n'est pas égal à l'autre.
< Une valeur est inférieure à une autre.
<= Une valeur est inférieure ou égale à une autre.
> Une valeur est supérieure à une autre.
>= Une valeur est supérieure ou égale à une autre.
in Un élément est contenu dans une collection.
and renvoyer les éléments correspondant aux deux requêtes.
or Affiche les éléments correspondant à l'une ou l'autre des requêtes.
not Annule une requête de recherche.
has Une collection contient un élément correspondant aux paramètres.

Termes de requête spécifiques aux fichiers

Le tableau suivant répertorie tous les termes de requête de fichier valides. Pour obtenir des informations sur les types de données et les descriptions, consultez la documentation de référence sur la ressource files.

Terme de requête Opérateurs valides Utilisation
name contains, =, != Nom du fichier. Entourez-les de guillemets simples ('). Échappez les guillemets simples dans les requêtes avec \', par exemple 'Valentine\'s Day'.
fullText contains Indique si les propriétés name, description, indexableText ou le texte du contenu ou des métadonnées du fichier correspondent. Entourez-les de guillemets simples ('). Échappez les guillemets simples dans les requêtes avec \', par exemple 'Valentine\'s Day'.
mimeType contains, =, != Type MIME du fichier. Entourez-les de guillemets simples ('). Échappez les guillemets simples dans les requêtes avec \', par exemple 'Valentine\'s Day'. Pour en savoir plus sur les types MIME, consultez Types MIME compatibles avec Google Workspace et Google Drive.
modifiedTime <=, <, =, !=, >, >= Date de la dernière modification du fichier. Format RFC 3339, fuseau horaire par défaut UTC, par exemple 2012-06-04T12:00:00-08:00. Les champs de type date ne sont pas comparables entre eux, mais uniquement à des dates constantes.
viewedByMeTime <=, <, =, !=, >, >= Date à laquelle l'utilisateur a consulté un fichier pour la dernière fois. Format RFC 3339, fuseau horaire par défaut UTC, par exemple 2012-06-04T12:00:00-08:00. Les champs de type date ne sont pas comparables entre eux, mais uniquement à des dates constantes.
trashed =, != Indique si le fichier se trouve dans la corbeille ou non. Il peut s'agir de true ou false.
starred =, != Indique si le fichier est suivi ou non. Il peut s'agir de true ou false.
parents in Indique si la collection de parents contient l'ID spécifié.
owners in Utilisateurs propriétaires du fichier.
writers in Utilisateurs ou groupes autorisés à modifier le fichier. Consultez la documentation de référence sur la ressource permissions.
readers in Utilisateurs ou groupes autorisés à lire le fichier. Consultez la documentation de référence sur la ressource permissions.
sharedWithMe =, != Fichiers de la collection "Partagés avec moi" de l'utilisateur. Tous les utilisateurs du fichier figurent dans la liste de contrôle d'accès (LCA) du fichier. Peut correspondre à true ou false.
createdTime <=, <, =, !=, >, >= Date de création du fichier. Utilisez le format RFC 3339. Le fuseau horaire par défaut est UTC, par exemple 2012-06-04T12:00:00-08:00.
properties has Propriétés de fichier personnalisées publiques.
appProperties has Propriétés de fichier personnalisées privées.
visibility =, != Niveau de visibilité du fichier. Les valeurs valides sont anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink et limited. Entourez-les de guillemets simples (').
shortcutDetails.targetId =, != ID de l'élément vers lequel pointe le raccourci.

Voici des exemples de combinaisons d'opérateurs et de termes de requête :

  • L'opérateur contains n'effectue que la correspondance de préfixe pour un terme name. Par exemple, supposons que vous ayez le nom HelloWorld. Une requête name contains 'Hello' renvoie un résultat, mais pas une requête name contains 'World'.

  • L'opérateur contains ne correspond qu'à des jetons de chaîne entiers pour le terme fullText. Par exemple, si le texte intégral d'un document contient la chaîne "HelloWorld", seule la requête fullText contains 'HelloWorld' renvoie un résultat.

  • L'opérateur contains correspond à une expression alphanumérique exacte si l'opérande de droite est entouré de guillemets doubles. Par exemple, si le fullText d'un document contient la chaîne"Hello there world", la requête fullText contains '"Hello there"' renvoie un résultat, mais pas la requête fullText contains '"Hello world"'. De plus, comme la recherche est alphanumérique, si le texte intégral d'un document contient la chaîne "Hello_world", la requête fullText contains '"Hello world"' renvoie un résultat.

  • Les termes owners, writers et readers sont indirectement reflétés dans la liste permissions et font référence à role sur l'autorisation. Pour obtenir la liste complète des autorisations des rôles, consultez Rôles et autorisations.

Pour obtenir d'autres exemples de recherches avec des chaînes de requête, consultez Exemples de chaînes de requête pour les fichiers.

Termes de requête spécifiques aux Drive partagés

Le tableau suivant répertorie tous les termes de requête valides pour les Drive partagés. Pour connaître les types de données et les descriptions, consultez la documentation de référence sur la ressource drives.

Terme de requête Opérateurs valides Utilisation useDomainAdminAccess paramètre
createdTime <=, <, =, !=, >, >= Date de création du Drive partagé. Format RFC 3339, fuseau horaire par défaut UTC, par exemple 2012-06-04T12:00:00-08:00. true
hidden =, != Indique si le Drive partagé est masqué. Il peut s'agir de true ou false. false
memberCount <=, <, =, !=, >, >= Nombre d'utilisateurs et de groupes membres du Drive partagé. Prend une valeur numérique. true
name contains, =, != Nom du Drive partagé. Entourez-les de guillemets simples ('). Échappez les guillemets simples dans les requêtes avec \', par exemple 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Nombre d'utilisateurs et de groupes qui sont organisateurs du Drive partagé. Prend une valeur numérique. true
orgUnitId =, != ID de l'unité organisationnelle d'un Drive partagé. Accepte une valeur de chaîne. true

Pour obtenir d'autres exemples de recherches avec des chaînes de requête, consultez Exemples de chaînes de requête pour les Drive partagés.