REST Resource: approvals

Recurso: Approval

Metadatos de una aprobación. Una aprobación es un proceso de revisión o aprobación de un elemento de Drive.

Representación JSON 
{
  "kind": string,
  "approvalId": string,
  "targetFileId": string,
  "createTime": string,
  "modifyTime": string,
  "completeTime": string,
  "dueTime": string,
  "status": enum (Status),
  "initiator": {
    object (User)
  },
  "reviewerResponses": [
    {
      object (ReviewerResponse)
    }
  ]
}
Campos
kind

string

Siempre es drive#approval.
approvalId

string

Es el ID de la aprobación.
targetFileId

string

Es el ID del archivo de destino de la aprobación.
createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó 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".
modifyTime

string (Timestamp format)

Solo salida. Es la hora más reciente en la que se modificó 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".
completeTime

string (Timestamp format)

Solo salida. Es la hora en la que se completó 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".
dueTime

string (Timestamp format)

Es la hora en la que vence 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".
status

enum (Status)

Solo salida. Es el estado de la aprobación en el momento en que se solicitó este recurso.
initiator

object (User)

Es el usuario que solicitó la aprobación.
reviewerResponses[]

object (ReviewerResponse)

Son las respuestas que los revisores hicieron sobre la aprobación.

Estado

Estados posibles de una aprobación.

Enums
STATUS_UNSPECIFIED El estado de aprobación no se estableció o se estableció en un valor no válido.
IN_PROGRESS El proceso de aprobación comenzó y no finalizó.
APPROVED El proceso de aprobación finalizó y se aprobó el destino.
CANCELLED El proceso de aprobación se canceló antes de que finalizara.
DECLINED El proceso de aprobación finalizó y se rechazó el destino.

ReviewerResponse

Es una respuesta sobre una aprobación realizada por un revisor específico.

Representación JSON 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
Campos
kind

string

Siempre es drive#reviewerResponse.
reviewer

object (User)

Es el usuario responsable de esta respuesta.
response

enum (Response)

Es la respuesta de un revisor para la aprobación.

Respuesta

Respuestas posibles para una aprobación.

Enums
RESPONSE_UNSPECIFIED La respuesta se estableció en un valor no reconocido.
NO_RESPONSE El revisor no respondió.
APPROVED El revisor aprobó el elemento.
DECLINED El revisor rechazó el elemento.

Métodos

approve

 Aprueba una aprobación.

cancel

 Cancela una aprobación.

comment

 Comenta una aprobación.

decline

 Rechaza una aprobación.

get

 Obtiene una aprobación por ID.

list

 Muestra las aprobaciones de un archivo.

reassign

 Reasigna los revisores en una aprobación.

start

 Inicia una aprobación en un archivo.