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