Method: files.list

• Richiesta HTTP
• Parametri di ricerca
• Corpo della richiesta
• Corpo della risposta
  • Rappresentazione JSON
• Ambiti di autorizzazione
• Corpus
• Prova!

Elenca i file dell'utente.

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

Nota: questo metodo restituisce tutti i file per impostazione predefinita, inclusi quelli spostati nel cestino. Se non vuoi che i file spostati nel cestino vengano visualizzati nell'elenco, utilizza il parametro di query trashed=false per rimuovere i file spostati nel cestino dai risultati.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
corpora	string Corpi di elementi (file/documenti) a cui si applica la query. Gli organismi supportati sono default, domain, drive e allDrives. Preferisci default o drive a allDrives per una maggiore efficienza.
corpus (deprecated)	enum (Corpus) Deprecato: il corpo degli elementi (file/documenti) a cui si applica la query. Usa invece il criterio corpora.
driveId	string ID del Drive condiviso in cui eseguire la ricerca.
includeItemsFromAllDrives	boolean Indica se includere sia gli elementi di Il mio Drive sia quelli del Drive condiviso nei risultati.
includeTeamDriveItems (deprecated)	boolean Deprecato: usa invece includeItemsFromAllDrives.
maxResults	integer Il numero massimo di file da restituire per pagina. Le pagine dei risultati parziali o vuote sono possibili anche prima della fine dell'elenco di file.
orderBy	string Un elenco di chiavi di ordinamento separate da virgole. Le chiavi valide sono createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred, title e title_natural. Per impostazione predefinita, ogni tasto è in ordine crescente, ma può essere invertito con il tasto di modifica desc. Esempio di utilizzo: ?orderBy=folder,modifiedDate desc,title. Tieni presente che al momento esiste una limitazione per gli utenti con circa un milione di file in cui l'ordinamento richiesto viene ignorato.
pageToken	string Token di pagina per i file.
projection (deprecated)	enum (Projection) Deprecato: questo parametro non ha funzione.
q	string Stringa di query per la ricerca di file.
spaces	string Un elenco di spazi separati da virgole in cui eseguire una query. I valori supportati sono drive e appDataFolder.
supportsAllDrives	boolean Se l'applicazione che ha inviato la richiesta supporta sia I miei Drive sia i Drive condivisi.
supportsTeamDrives (deprecated)	boolean Deprecato: usa invece supportsAllDrives.
teamDriveId (deprecated)	string Deprecato: usa invece driveId.
includePermissionsForView	string Specifica le autorizzazioni di visualizzazione aggiuntive da includere nella risposta. È supportato solo published.
includeLabels	string Un elenco di ID di etichette separati da virgole da includere nella parte labelInfo della risposta.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un elenco di file.

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

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

Campi
nextPageToken	string Il token di pagina per la pagina successiva di file. 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 deve essere riavviata dalla prima pagina dei risultati.
kind	string Il valore è sempre drive#fileList.
etag	string L'ETag dell'elenco.
selfLink	string Un link per tornare a questo elenco.
incompleteSearch	boolean Indica se il processo di ricerca era incompleto. Se il valore è true, alcuni risultati di ricerca potrebbero non essere disponibili, in quanto non è stata eseguita la ricerca in tutti i documenti. Questo può verificarsi quando cerchi più viaggi con "allDrives" ma non era possibile eseguire ricerche in tutti i corpora. In questo caso, è consigliabile che i clienti restringano la query scegliendo un corpus diverso, ad esempio "predefinito" o "drive".
nextLink	string Un link alla pagina successiva di file.
items[]	object (File) L'elenco dei file. Se nextPageToken è compilato, questo elenco potrebbe essere incompleto e dovrebbe essere recuperata un'ulteriore pagina di risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

• 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

Alcuni ambiti sono limitati e richiedono una valutazione della sicurezza per consentire alla tua app di utilizzarli. Per ulteriori informazioni, consulta la Guida all'autorizzazione.

Corpus

Enum
DEFAULT	Gli elementi a cui l'utente ha eseguito l'accesso.
DOMAIN	Elementi condivisi con il dominio dell'utente.