Method: files.list

• Requête HTTP
• Paramètres de requête
• Corps de la requête
• Corps de la réponse
  • Représentation JSON
• Champs d'application des autorisations
• Corpus
• Essayer

Liste les fichiers de l'utilisateur.

Cette méthode accepte le paramètre q, qui est une requête de recherche combinant un ou plusieurs termes de recherche. Pour plus d'informations, consultez la section Rechercher des fichiers dossier.

Remarque:Par défaut, cette méthode renvoie tous les fichiers, y compris ceux placés dans la corbeille. Si vous ne souhaitez pas que les fichiers placés dans la corbeille s'affichent dans la liste, utilisez le paramètre de requête trashed=false pour les supprimer des résultats.

Requête HTTP

GET https://www.googleapis.com/drive/v2/files

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
corpora	string Ensembles d'éléments (fichiers/documents) auxquels la requête s'applique. Les corps compatibles sont default, domain, drive et allDrives. Pour plus d'efficacité, préférez default ou drive à allDrives.
corpus (deprecated)	enum (Corpus) Obsolète: corps des éléments (fichiers/documents) auxquels la requête s'applique. Utilisez corpora à la place.
driveId	string ID du Drive partagé à rechercher.
includeItemsFromAllDrives	boolean Indique si les éléments Mon Drive et les éléments des Drive partagés doivent être inclus dans les résultats.
includeTeamDriveItems (deprecated)	boolean Obsolète: utilisez plutôt includeItemsFromAllDrives.
maxResults	integer Nombre maximal de fichiers à renvoyer par page. Il est possible d'afficher des pages de résultats partielles ou vides avant même d'atteindre la fin de la liste des fichiers.
orderBy	string Liste de clés de tri séparées par une virgule. Les clés valides sont createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred, title et title_natural. Par défaut, chaque clé est triée dans l'ordre croissant, mais vous pouvez l'inverser avec le modificateur desc. Exemple d'utilisation: ?orderBy=folder,modifyDate desc,title. Veuillez noter qu'il existe actuellement une limite pour les utilisateurs disposant d'environ un million de fichiers dans lesquels l'ordre de tri demandé est ignoré.
pageToken	string Jeton de page pour les fichiers.
projection (deprecated)	enum (Projection) Obsolète: ce paramètre n'a aucune fonction.
q	string Chaîne de requête pour la recherche de fichiers.
spaces	string Liste des espaces à interroger, séparés par une virgule. Les valeurs acceptées sont drive et appDataFolder.
supportsAllDrives	boolean Indique si l'application à l'origine de la demande est compatible avec Mon Drive et les Drive partagés.
supportsTeamDrives (deprecated)	boolean Obsolète: utilisez plutôt supportsAllDrives.
teamDriveId (deprecated)	string Obsolète: utilisez plutôt driveId.
includePermissionsForView	string Spécifie les autorisations de vue supplémentaires à inclure dans la réponse. Seule la fonctionnalité published est prise en charge.
includeLabels	string Liste d'ID de libellés séparés par une virgule à inclure dans la partie labelInfo de la réponse.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste de fichiers.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{ "nextPageToken": string, "kind": string, "etag": string, "selfLink": string, "incompleteSearch": boolean, "nextLink": string, "items": [ { object (File) } ] }

Champs
nextPageToken	string Jeton de page pour la page de fichiers suivante. Ce champ est absent si la fin de la liste des fichiers est atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats.
kind	string Il s'agit toujours de drive#fileList.
etag	string ETag de la liste.
selfLink	string Un lien vers cette liste.
incompleteSearch	boolean Indique si le processus de recherche était incomplet. Si la valeur est "true", certains résultats de recherche peuvent être manquants, car tous les documents n'ont pas fait l'objet d'une recherche. Cela peut se produire lorsque vous recherchez plusieurs Drive avec la commande "allDrives". mais tous les corpus n'ont pas pu être fouillés. Dans ce cas, il est conseillé aux clients de restreindre leur requête en choisissant un corpus différent, par exemple "default" ou "drive".
nextLink	string Lien vers la page de fichiers suivante.
items[]	object (File) Liste des fichiers. Si nextPageToken est renseigné, cette liste peut être incomplète et une page de résultats supplémentaire devra être extraite.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

• https://www.googleapis.com/auth/docs
• https://www.googleapis.com/auth/drive
• https://www.googleapis.com/auth/drive.appdata
• https://www.googleapis.com/auth/drive.apps.readonly
• https://www.googleapis.com/auth/drive.file
• https://www.googleapis.com/auth/drive.meet.readonly
• https://www.googleapis.com/auth/drive.metadata
• https://www.googleapis.com/auth/drive.metadata.readonly
• https://www.googleapis.com/auth/drive.photos.readonly
• https://www.googleapis.com/auth/drive.readonly

Certains champs d'application sont restreints et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le Guide relatif aux autorisations.

Corpus

Enums
DEFAULT	Éléments auxquels l'utilisateur a accédé.
DOMAIN	Éléments partagés avec le domaine de l'utilisateur.