- 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
, ovvero una query di ricerca che combina uno o più termini di ricerca. Per ulteriori informazioni, consulta la sezione Cercare file e cartelle.
Richiesta HTTP
GET https://www.googleapis.com/drive/v2/files
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
Parametri | |
---|---|
corpora |
Corpi di elementi (file/documenti) a cui si applica la query. Gli organismi 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 includere sia gli elementi di Il mio Drive sia quelli del Drive condiviso nei risultati. |
includeTeamDriveItems |
Deprecato: usa invece |
maxResults |
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 |
Un elenco di chiavi di ordinamento separate da virgole. Le chiavi valide sono |
pageToken |
Token di pagina per i file. |
projection |
Deprecato: questo parametro non ha funzione. |
q |
Stringa di query per la ricerca di file. |
spaces |
Un elenco di spazi separati da virgole in cui eseguire una query. I valori supportati sono |
supportsAllDrives |
Se l'applicazione che ha inviato la richiesta supporta sia I miei Drive sia i Drive condivisi. |
supportsTeamDrives |
Deprecato: usa invece |
teamDriveId |
Deprecato: usa invece |
includePermissionsForView |
Specifica le autorizzazioni di visualizzazione aggiuntive da includere nella risposta. È supportato solo |
includeLabels |
Un elenco di ID di etichette separati 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,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
Campi | |
---|---|
nextPageToken |
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 |
Il valore è sempre |
etag |
L'ETag dell'elenco. |
selfLink |
Un link per tornare a questo elenco. |
incompleteSearch |
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 |
Un link alla pagina successiva di file. |
items[] |
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. |