Method: approvals.start

Inicia una aprobación en un archivo.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
fileId

string

Obligatorio. El ID del archivo en el que se creará la aprobación.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Campos
reviewerEmails[]

string

Obligatorio. Los correos electrónicos de los usuarios que revisarán la aprobación.
dueTime

string (Timestamp format)

Es opcional. La hora de vencimiento de la aprobación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lockFile

boolean

Es opcional. Indica si se debe bloquear el archivo cuando se inicia la aprobación.
message

string

Es opcional. Un mensaje para enviar a los revisores cuando se les notifique la solicitud de aprobación.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Approval.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Algunos permisos son restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la guía de autorización.