Method: approvals.start

Inicia uma aprovação em um arquivo.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
fileId

string

Obrigatório. O ID do arquivo em que a aprovação será criada.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Campos
reviewerEmails[]

string

Obrigatório. Os e-mails dos usuários definidos para revisar a aprovação.
dueTime

string (Timestamp format)

Opcional. O prazo da aprovação.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lockFile

boolean

Opcional. Se o arquivo será bloqueado ao iniciar a aprovação.
message

string

Opcional. Uma mensagem a ser enviada aos revisores ao notificá-los sobre o pedido de aprovação.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Approval.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Alguns escopos são restritos e exigem uma avaliação de segurança para que seu app os use. Para mais informações, consulte o guia de autorização.