Utilisez la méthode files.list
pour renvoyer tout ou partie des fichiers et dossiers d'un utilisateur Drive.
Vous pouvez également utiliser la méthode files.list
pour récupérer le fileId
requis pour certaines méthodes de ressources (telles que files.get
et files.update
).
Rechercher tous les fichiers et dossiers dans le dossier Mon Drive de l'utilisateur actuel
Utilisez files.list
sans aucun paramètre pour renvoyer tous les fichiers et dossiers.
Rechercher des fichiers ou des dossiers spécifiques dans le dossier Mon Drive de l'utilisateur actuel
Pour rechercher un ensemble spécifique de fichiers ou de dossiers, utilisez le champ de chaîne de requête q
avec files.list
pour filtrer les fichiers à 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
est le terme ou le champ de requête à rechercher. Pour afficher les termes de requête permettant de filtrer les Drive partagés, consultez la section Termes et opérateurs de requête de recherche.operator
spécifie la condition du terme de requête. Pour afficher les opérateurs que vous pouvez utiliser avec chaque terme de requête, consultez la section Opérateurs de requête.values
correspond aux valeurs spécifiques que vous souhaitez utiliser pour filtrer les résultats de recherche.
Par exemple, la chaîne de requête suivante filtre la recherche pour ne renvoyer que des dossiers:
q: mimeType = 'application/vnd.google-apps.folder'
L'exemple suivant montre comment utiliser une bibliothèque cliente pour filtrer les résultats de recherche en fonction des noms et des ID de fichiers JPEG. Cet exemple utilise le terme de requête mimeType
pour limiter les résultats aux fichiers de type image/jpeg
. Cet exemple définit également spaces
sur drive
pour restreindre davantage la recherche à l' espace Drive. Lorsque nextPageToken
renvoie null
, il n'y a plus de résultats.
Java
Python
Node.js
PHP
Pour limiter la recherche aux dossiers, utilisez la chaîne de requête pour définir le type MIME sur q: mimeType = 'application/vnd.google-apps.folder'
.
Pour en savoir plus sur les types MIME, consultez la section Types MIME compatibles avec Google Workspace et Google Drive.
Exemples de chaînes de requête
Ce tableau présente quelques chaînes de requête de base. Le code réel diffère en fonction de la bibliothèque cliente que vous utilisez pour votre recherche.
Éléments que vous souhaitez interroger | Exemple |
---|---|
Fichiers nommés "hello" | name = 'hello' |
Fichiers dont le nom contient les mots "bonjour" et "au revoir" | name contains 'hello' and name contains 'goodbye' |
Fichiers dont le nom ne contient pas le mot "hello" | not name contains 'hello' |
Dossiers correspondant à des applications Google ou ayant le type MIME du dossier | mimeType = 'application/vnd.google-apps.folder' |
Fichiers qui ne sont pas des dossiers | mimeType != 'application/vnd.google-apps.folder' |
Fichiers contenant le texte "important" et dans la corbeille | fullText contains 'important' and trashed = true |
Fichiers contenant le mot "bonjour" | fullText contains 'hello' |
Fichiers ne contenant pas le mot "bonjour" | not fullText contains 'hello' |
Fichiers contenant l'expression exacte "hello world" | fullText contains '"hello world"' |
Fichiers dont la requête contient le caractère "\" (par exemple, "\auteurs") | fullText contains '\\authors' |
Fichiers avec ID dans une collection (par exemple, parents ) |
'1234567' in parents |
Fichiers d'un dossier de données d'application dans une collection | 'appDataFolder' in parents |
Fichiers pour lesquels l'utilisateur "test@example.org" dispose d'une autorisation d'écriture | 'test@example.org' in writers |
Fichiers pour lesquels les membres du groupe "group@example.org" disposent d'une autorisation d'écriture | 'group@example.org' in writers |
Fichiers modifiés après une date donnée | modifiedTime > '2012-06-04T12:00:00' // default time zone is UTC |
Fichiers partagés avec l'utilisateur autorisé dont le nom contient "hello" | sharedWithMe and name contains 'hello' |
Fichiers qui n'ont été partagés avec personne ni avec des domaines (privés uniquement, ou partagés avec des utilisateurs ou des groupes spécifiques) | visibility = 'limited' |
Fichiers image ou vidéo modifiés après une date spécifique | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
Rechercher des fichiers avec une propriété de fichier personnalisée
Pour rechercher des fichiers avec une propriété de fichier personnalisée, utilisez le terme de requête de recherche appProperties
avec une clé et une valeur. Par exemple, pour rechercher une propriété de fichier personnalisé appelée additionalID
avec la valeur 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Pour en savoir plus sur les propriétés de fichiers personnalisées, consultez Ajouter des propriétés de fichier personnalisées.
Rechercher des fichiers associés à un libellé ou une valeur de champ spécifique
Pour rechercher des fichiers associés à des libellés spécifiques, utilisez le terme de requête de recherche labels
avec un ID de libellé spécifique. Par exemple : 'labels/LABEL_ID'
in labels
Pour rechercher des fichiers sans ID de libellé spécifique: Not
'labels/LABEL_ID' in labels
Vous pouvez également rechercher des fichiers en fonction de valeurs de champs spécifiques. Par exemple, pour rechercher des fichiers avec une valeur textuelle : labels/LABEL_ID.text_field_id =
'TEXT'
Pour en savoir plus, consultez Rechercher des fichiers associés à un libellé ou une valeur de champ spécifiques.
Effectuer des recherches dans les corpus
Les recherches qui appellent files.list
utilisent le corps user
par défaut. Pour rechercher d'autres corpus, tels que des fichiers partagés avec un domaineGoogle Workspace , utilisez le paramètre corpora
.
Plusieurs corpus peuvent être recherchés dans une même requête, bien que des résultats incomplets puissent être renvoyés si le corpus combiné est trop volumineux. Si le résultat incompleteSearch
est true
, tous les documents n'ont pas été renvoyés.