- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Corpo
- 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 guida Cercare file e cartelle.
Richiesta HTTP
GET https://www.googleapis.com/drive/v2/files
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di ricerca
Parametri | |
---|---|
corpora |
Corpi di elementi (file/documenti) a cui si applica la query. I corpi supportati sono |
corpus |
Deprecato: il corpo degli elementi (file/documenti) a cui si applica la query. Usa invece il criterio |
driveId |
ID del Drive condiviso in cui eseguire la ricerca. |
includeItemsFromAllDrives |
Indica se gli elementi di Il mio Drive e del Drive condiviso devono essere inclusi nei risultati. |
includeTeamDriveItems |
Obsoleto: utilizza |
maxResults |
Il numero massimo di file da restituire per pagina. È possibile creare pagine di risultati parziali o vuote anche prima che venga raggiunta la fine dell'elenco dei file. |
orderBy |
Un elenco separato da virgole di chiavi di ordinamento. Le chiavi valide sono |
pageToken |
Token di pagina per i file. |
projection |
Deprecato: questo parametro non contiene funzioni. |
q |
Stringa di query per la ricerca di file. |
spaces |
Un elenco separato da virgole di spazi in cui eseguire una query. I valori supportati sono |
supportsAllDrives |
Indica se l'applicazione richiedente supporta sia I miei Drive sia i Drive condivisi. |
supportsTeamDrives |
Obsoleto: utilizza |
teamDriveId |
Obsoleto: utilizza |
includePermissionsForView |
Specifica quali autorizzazioni di visualizzazione aggiuntive includere nella risposta. È supportato soltanto l'elemento |
includeLabels |
Un elenco separato da virgole di ID delle etichette da includere nella parte |
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 ( |
Campi | |
---|---|
nextPageToken |
Il token di pagina per la pagina successiva dei file. Questo campo non sarà presente se hai raggiunto 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 |
È sempre |
etag |
L'ETag dell'elenco. |
selfLink |
Un link per tornare all'elenco. |
incompleteSearch |
Indica se il processo di ricerca era incompleto. Se il valore è true, alcuni risultati di ricerca potrebbero non essere disponibili perché la ricerca non è stata eseguita in tutti i documenti. Questo può verificarsi quando cerchi più unità con i corpora "allDrives", ma non è stato possibile cercare in tutti i corpora. In questi casi, è consigliabile che i client restringano la query scegliendo un corpus diverso, ad esempio "default" o "drive". |
nextLink |
Un link alla pagina di file successiva. |
items[] |
L'elenco di 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.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 di sicurezza affinché l'app li utilizzi. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.
Corpus
Enum | |
---|---|
DEFAULT |
Gli elementi a cui l'utente ha avuto accesso. |
DOMAIN |
Elementi condivisi con il dominio dell'utente. |