Ce guide de référence fournit des termes de requête et des opérateurs que vous pouvez utiliser avec l'API Google Drive pour 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 contient les 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
sont les 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'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 des é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 aux fichiers
Le tableau suivant répertorie tous les termes de requête de fichier valides. Pour en savoir plus 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 , = et != |
Nom du fichier. Entourez les 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 guillemets simples (' ). Échappez les guillemets simples dans les requêtes avec \' , par exemple 'Valentine\'s Day' . |
mimeType |
contains , = et != |
Type MIME du fichier. Entourez les 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. 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. Il peut s'agir de true ou de false . |
starred |
= , != |
Indique si le fichier est suivi ou non. Il peut s'agir de true ou de 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 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 |
= , != |
les fichiers figurant dans 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 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 des fichiers personnalisés publics. |
appProperties |
has |
Propriétés des fichiers personnalisés privés. |
visibility |
= , != |
Niveau de visibilité du fichier. Les valeurs valides sont anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink et limited . Entourez-le de guillemets simples (' ). |
shortcutDetails.targetId |
= , != |
ID de l'élément vers lequel pointe le raccourci. |
L'exemple suivant illustre les combinaisons d'opérateurs et de termes de requête:
L'opérateur
contains
n'effectue une correspondance de préfixe que pour un termename
. Par exemple, supposons que vous ayez le nomHelloWorld
. Une requêtename contains 'Hello'
renvoie un résultat, mais pas une requêtename contains 'World'
.L'opérateur
contains
n'effectue une correspondance que sur les jetons de chaîne entières pour le termefullText
. Par exemple, si le texte complet d'un document contient la chaîne "HelloWorld", seule la requêtefullText contains 'HelloWorld'
renvoie un résultat.L'opérateur
contains
établit une correspondance avec un groupe de caractères alphanumériques exact s'il est entouré de guillemets doubles. Par exemple, si lefullText
d'un document contient la chaîne"Hello here world", la requêtefullText contains '"Hello there"'
renvoie un résultat, mais pas la requêtefullText contains '"Hello world"'
. De plus, comme la recherche est alphanumérique, si le texte complet d'un document contient la chaîne "Hello_world", la requêtefullText contains '"Hello world"'
renvoie un résultat.Les termes
owners
,writers
etreaders
sont indirectement reflétés dans la listepermissions
et font référence aurole
sur l'autorisation. Pour obtenir la liste complète des autorisations associées aux rôles, consultez la page Rôles et autorisations.
Pour plus d'exemples de recherches de chaîne de requête, consultez la section Exemples de chaînes de requête de fichier.
Termes de requête spécifiques aux Drive partagés
Le tableau suivant liste tous les termes de requête valides pour un Drive partagé. Pour en savoir plus sur 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. 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é. Il peut s'agir de true ou de false . |
false |
memberCount |
<= , < , = , != , > , >= |
Nombre d'utilisateurs et de groupes membres du Drive partagé. Prend une valeur numérique. | true |
name |
contains , = et != |
Nom du Drive partagé. Entourez les guillemets simples (' ). Échappez les guillemets simples dans les requêtes avec \' , par exemple 'Valentine\'s Day' . |
true |
organizerCount |
<= , < , = , != , > , >= |
Nombre d'utilisateurs et de groupes organisateur du Drive partagé. Prend une valeur numérique. | true |
orgUnitId |
= , != |
ID d'unité organisationnelle d'un Drive partagé. Utilise une valeur de chaîne. | true |
Pour plus d'exemples de recherches de chaînes de requête, consultez Exemples de chaînes de requête de Drive partagés.
Articles associés
- Rechercher des fichiers et des dossiers
- Rechercher des Drive partagés
- Types MIME compatibles avec Google Workspace et Google Drive
- Rôles et autorisations