- 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/v3/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 "user", "domain", "drive" e "allDrives". Per maggiore efficienza, preferisci "utente" o "drive" a "allDrives". Per impostazione predefinita, corpora è impostato su "user". Tuttavia, questo può cambiare a seconda del filtro impostato tramite il parametro "q". |
corpus |
Deprecato: l'origine dei file da elencare. Utilizza invece "corpora". |
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 |
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". Per impostazione predefinita, ogni tasto viene ordinato in senso crescente, ma può essere invertito con il modificatore "desc". Esempio di utilizzo: ?orderBy=folder,modifiedTime desc,name. |
pageSize |
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. |
pageToken |
Il token per continuare una precedente richiesta di elenco nella pagina successiva. Deve essere impostato sul valore di "nextPageToken" dalla risposta precedente. |
q |
Una query per filtrare i risultati del file. Consulta la guida "Cercare file e cartelle" per conoscere la sintassi supportata. |
spaces |
Un elenco separato da virgole di spazi su cui eseguire una query all'interno dei corpora. I valori supportati sono "drive" e "appDataCartella". |
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 solo lo stato "pubblicato". |
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,
"incompleteSearch": boolean,
"files": [
{
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. Il token della pagina è in genere valido per diverse ore. Tuttavia, se vengono aggiunti o rimossi nuovi elementi, i risultati previsti potrebbero essere diversi. |
kind |
Identifica il tipo di risorsa. Valore: la stringa fissa |
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ù viaggi con il 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 "user" o "drive". |
files[] |
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/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 di sicurezza affinché l'app li utilizzi. Per ulteriori informazioni, consulta la Guida alle autorizzazioni.
Corpus
Enum | |
---|---|
user |
File di proprietà dell'utente o condivisi con l'utente. |
domain |
File condivisi con il dominio dell'utente. |