- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Corpus
- Prova!
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 |
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 |
Deprecato: l'origine dei file da elencare. Al suo posto, usa "corpora". |
driveId |
ID del Drive condiviso in cui eseguire la ricerca. |
includeItemsFromAllDrives |
Indica se gli elementi di Il mio Drive e di Drive condiviso devono essere inclusi nei risultati. |
includeTeamDriveItems |
Obsoleto: utilizza |
orderBy |
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 |
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 |
Il token per continuare una richiesta di elenco precedente nella pagina successiva. Deve essere impostato sul valore "nextPageToken" dalla risposta precedente. |
q |
Una query per filtrare i risultati del file. Consulta la guida "Cerca file e cartelle" per conoscere la sintassi supportata. |
spaces |
Un elenco di spazi separati da virgole per eseguire query all'interno del corpora. I valori supportati sono "drive" e "appDataFolder". |
supportsAllDrives |
Indica se l'applicazione richiedente supporta sia Il mio Drive sia i Drive condivisi. |
supportsTeamDrives |
Obsoleto: utilizza |
teamDriveId |
Obsoleto: utilizza |
includePermissionsForView |
Specifica le autorizzazioni di visualizzazione aggiuntive da includere nella risposta. È supportato solo "pubblicato". |
includeLabels |
Un elenco di ID delle etichette separato da virgole 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,
"incompleteSearch": boolean,
"files": [
{
object ( |
Campi | |
---|---|
nextPageToken |
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. Il token della pagina è in genere valido per diverse ore. Tuttavia, l'aggiunta o la rimozione di nuovi elementi potrebbe differire nei risultati previsti. |
kind |
Identifica il tipo di risorsa. Valore: la stringa fissa |
incompleteSearch |
Indica se il processo di ricerca è incompleto. Se true, alcuni risultati di ricerca potrebbero mancare perché non è stata eseguita alcuna ricerca in tutti i documenti. Questo può accadere quando si cerca in più Drive con il corpora "allDrives", ma non è stato possibile eseguire ricerche in tutti i Drive. In questo caso, suggeriamo ai clienti di restringere la query scegliendo un altro corpus, ad esempio "utente" o "drive". |
files[] |
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. |