Termes de requête et opérateurs de recherche

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

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

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

Syntaxe de la chaîne de requête

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 votre recherche. résultats.

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'une valeur booléenne 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 Renvoie les éléments qui correspondent aux deux requêtes.
or Renvoie les éléments qui correspondent à 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 à un fichier

Le tableau suivant répertorie tous les termes de requête de fichier valides. Pour les types de données et reportez-vous à la ressource files référence.

Terme de requête Opérateurs valides Utilisation
name contains, =, != Nom du fichier. Entourez de guillemets simples ('). Échappez les guillemets simples dans les requêtes avec \', comme 'Valentine\'s Day'.
fullText contains Indique si les propriétés name, description, indexableText ou le texte figurant dans le contenu ou les métadonnées du fichier correspondent. Entourez de guillemets simples ('). Échappez les guillemets simples dans les requêtes avec \', comme 'Valentine\'s Day'.
mimeType contains, =, != Type MIME du fichier. Entourez de guillemets simples ('). Échappez les guillemets simples dans les requêtes avec \', comme '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, le fuseau horaire par défaut est UTC, par exemple 2012-06-04T12:00:00-08:00. Les champs de type date ne sont pas comparables les uns aux autres, mais uniquement aux dates constantes.
viewedByMeTime <=, <, =, !=, >, >= Date à laquelle l'utilisateur a consulté un fichier pour la dernière fois. Format RFC 3339, le fuseau horaire par défaut est UTC, par exemple 2012-06-04T12:00:00-08:00. Les champs de type date ne sont pas comparables les uns aux autres, mais uniquement aux dates constantes.
trashed =, != Indique si le fichier se trouve dans la corbeille ou non. Peut prendre la valeur true ou false.
starred =, != Indique si le fichier est suivi ou non. Peut prendre la valeur true ou false.
parents in Indique si la collection parente 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 de la ressource permissions.
readers in Utilisateurs ou groupes autorisés à lire le fichier. Consultez la documentation de référence de la ressource permissions.
sharedWithMe =, != les fichiers figurant dans la section Partagés avec moi" de l'utilisateur ; collection. Tous les utilisateurs du fichier figurent sur la liste de contrôle d'accès (LCA) du fichier. Peut correspondre à true ou false.
createdTime <=, <, =, !=, >, >= Date de création du Drive partagé. 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 publiques des fichiers personnalisés
appProperties has Propriétés privées des fichiers personnalisés
visibility =, != Niveau de visibilité du fichier. Les valeurs valides sont anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink et limited. Entourez de guillemets simples (').
shortcutDetails.targetId =, != ID de l'élément vers lequel pointe le raccourci.

Voici un exemple de combinaisons d'opérateurs et de termes de requête:

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

  • L'opérateur contains n'effectue la mise en correspondance que sur les jetons de chaîne entière 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 établit une correspondance avec un syntagme alphanumérique exact s'il est entouré de guillemets. Par exemple, si le paramètre 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, la recherche étant alphanumérique, si la chaîne texte 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 le permissions et reportez-vous à la role sur l'autorisation. Pour obtenir la liste complète des autorisations associées à chaque rôle, consultez Rôles et autorisations

Pour plus d'exemples de recherches de chaînes de requête, consultez la section Chaîne de requête de fichier exemples.

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 les types de données et consultez la ressource drives référence.

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

Pour plus d'exemples de recherche de chaîne de requête, consultez la section Chaîne de requête des Drive partagés exemples.