Method: approvals.start

Avvia un'approvazione su un file. Per saperne di più, consulta 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,
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
Campi
reviewerEmails[]

string

Obbligatorio. Le email degli utenti impostati per la revisione dell'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. Se bloccare il file all'avvio dell'approvazione.
message

string

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

enum (FileContentChangeBehavior)

Facoltativo. Il comportamento dell'approvazione quando cambia il contenuto del file.

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 soggetti a restrizioni e richiedono una valutazione della sicurezza per poter essere utilizzati dalla tua app. Per ulteriori informazioni, consulta la Guida all'autorizzazione.