Method: files.list

Elenca i file dell'utente.

Questo metodo accetta il parametro q, che è una query di ricerca che combina uno o più termini di ricerca. Per ulteriori informazioni, consulta la guida Cercare file e cartelle.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
corpora

string

Corpo degli elementi (file/documenti) a cui si applica la query. I corpi supportati sono "user", "domain", "drive" e "allDrives". Per maggiore efficienza, scegli "user" o "drive" a "allDrives". Per impostazione predefinita, corpora è impostata su "utente". Tuttavia, questo può cambiare a seconda del filtro impostato tramite il parametro "q".

corpus
(deprecated)

enum (Corpus)

Deprecato: l'origine dei file da elencare. Al suo posto, usa "corpora".

driveId

string

ID del Drive condiviso in cui eseguire la ricerca.

includeItemsFromAllDrives

boolean

Indica se gli elementi di Il mio Drive e di Drive condiviso devono essere inclusi nei risultati.

includeTeamDriveItems
(deprecated)

boolean

Obsoleto: utilizza includeItemsFromAllDrives.

orderBy

string

Un elenco separato da virgole di chiavi di ordinamento. Le chiavi valide sono 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred' e 'viewedByMeTime'. Ogni chiave è in ordine crescente per impostazione predefinita, ma può essere invertita con il modificatore "desc". Esempio di utilizzo: ?orderBy=folder,modifiedTime desc,name.

pageSize

integer

Il numero massimo di file da restituire per pagina. Le pagine dei risultati parziali o vuote sono possibili anche prima che venga raggiunta la fine dell'elenco dei file.

pageToken

string

Il token per continuare una richiesta di elenco precedente nella pagina successiva. Deve essere impostato sul valore "nextPageToken" dalla risposta precedente.

q

string

Una query per filtrare i risultati del file. Consulta la guida "Cerca file e cartelle" per conoscere la sintassi supportata.

spaces

string

Un elenco di spazi separati da virgole per eseguire query all'interno del corpora. I valori supportati sono "drive" e "appDataFolder".

supportsAllDrives

boolean

Indica se l'applicazione richiedente supporta sia Il mio Drive sia i Drive condivisi.

supportsTeamDrives
(deprecated)

boolean

Obsoleto: utilizza supportsAllDrives.

teamDriveId
(deprecated)

string

Obsoleto: utilizza driveId.

includePermissionsForView

string

Specifica le autorizzazioni di visualizzazione aggiuntive da includere nella risposta. È supportato solo "pubblicato".

includeLabels

string

Un elenco di ID delle etichette separato da virgole da includere nella parte labelInfo della risposta.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Un elenco di file.

Rappresentazione JSON
{
  "nextPageToken": string,
  "kind": string,
  "incompleteSearch": boolean,
  "files": [
    {
      object (File)
    }
  ]
}
Campi
nextPageToken

string

Il token della pagina per la pagina successiva dei file. Questa informazione non sarà presente se è stata raggiunta la fine dell'elenco dei file. Se per qualsiasi motivo il token viene rifiutato, deve essere eliminato e l'impaginazione dovrebbe essere riavviata dalla prima pagina dei risultati.

kind

string

Identifica il tipo di risorsa. Valore: la stringa fissa "drive#fileList".

files[]

object (File)

L'elenco dei file. Se il valore di NextPageToken viene completato, questo elenco potrebbe essere incompleto e recuperare una pagina aggiuntiva dei risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • 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

Alcuni ambiti sono limitati e richiedono una valutazione della sicurezza per essere utilizzati nella tua app. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.

Corpus

Enum
user I file di proprietà o condivisi con l'utente.
domain File condivisi con il dominio dell'utente.