Method: files.list

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.

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.
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.