Method: approvals.start

Avvia un'approvazione su un file.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
fileId

string

Obbligatorio. L'ID del file su cui verrà creata l'approvazione.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Campi
reviewerEmails[]

string

Obbligatorio. Gli indirizzi email degli utenti che devono esaminare l'approvazione.
dueTime

string (Timestamp format)

Facoltativo. L'ora in cui è prevista l'approvazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lockFile

boolean

Facoltativo. Indica se bloccare il file all'avvio dell'approvazione.
message

string

Facoltativo. Un messaggio da inviare ai revisori quando vengono informati della richiesta di approvazione.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Approval.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

Alcuni ambiti sono limitati e richiedono una valutazione della sicurezza per l'utilizzo da parte della tua app. Per ulteriori informazioni, consulta la guida all'autorizzazione.