Method: approvals.list

Elenca le approvazioni di un file. Per saperne di più, vedi Gestire le approvazioni.

Per impostazione predefinita, questo metodo restituisce una risposta minima che potrebbe non includere l'array items. Per recuperare i dettagli dell'approvazione, devi specificare esplicitamente i campi che vuoi utilizzare il parametro di query fields. Per restituire i campi esatti di cui hai bisogno, vedi Restituire campi specifici.

Richiesta HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/approvals

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
fileId

string

Obbligatorio. L'ID del file su cui si basa l'approvazione.

Parametri di query

Parametri
pageSize

integer

Il numero massimo di approvazioni da restituire. Se non è impostato, vengono restituite al massimo 100 approvazioni.

pageToken

string

Il token per continuare una richiesta di elenco precedente nella pagina successiva. Questo valore deve essere impostato sul valore di nextPageToken di una risposta precedente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta a una richiesta di elenco di approvazioni.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "kind": string,
  "items": [
    {
      object (Approval)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Questo valore è sempre drive#approvalList

items[]

object (Approval)

L'elenco delle approvazioni. Se nextPageToken è compilato, questo elenco potrebbe essere incompleto e deve essere recuperata una pagina aggiuntiva di risultati.

nextPageToken

string

Il token di pagina per la pagina successiva di approvazioni. Questo valore non è presente se è stata raggiunta la fine dell'elenco delle approvazioni. Se il token viene rifiutato per qualsiasi motivo, deve essere eliminato e la paginazione deve essere riavviata dalla prima pagina 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.readonly

Alcuni ambiti sono limitati e richiedono una valutazione della sicurezza per l'utilizzo da parte dell'app. Per saperne di più, consulta la guida all'autorizzazione.