Method: approvals.start

Avvia un'approvazione su un file. Per saperne di più, vedi Gestire le approvazioni.

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 viene 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. Le 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 dell'app. Per saperne di più, consulta la guida all'autorizzazione.