REST Resource: approvals

Recurso: Approval

Son los 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)
    }
  ],
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
Campos
kind

string

Siempre es drive#approval.
approvalId

string

Es el ID de aprobación.
targetFileId

string

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

string (Timestamp format)

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)

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)

Es la hora en 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)

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 dieron los revisores sobre la aprobación.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Es el comportamiento de la aprobación cuando cambia el contenido del archivo.

Estado

Son los posibles estados de una aprobación.

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

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

Posibles respuestas para una aprobación.

Enums
RESPONSE_UNSPECIFIED La respuesta se estableció en un valor no reconocido.
NO_RESPONSE El usuario que dejó la opinión no respondió.
APPROVED El revisor aprobó el elemento.
DECLINED El revisor rechazó el elemento.

FileContentChangeBehavior

Es el comportamiento de la aprobación cuando cambia el contenido del archivo mientras el Status de aprobación es IN_PROGRESS. Este comportamiento ya no se produce una vez que se completa la aprobación.

Enums
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED El comportamiento no está especificado.
RESET_APPROVAL Cualquier ReviewerResponse con un Response de APPROVED se restablecerá a NO_DECISION cuando cambie el contenido del archivo mientras la aprobación tenga un Status de IN_PROGRESS. Cuando la aprobación tiene un Status de APPROVED y se selecciona RESET_APPROVAL, el archivo se bloquea.
NO_APPROVAL_ACTION No se realiza ninguna acción cuando cambia el contenido del archivo.

Métodos

approve

 Aprueba una aprobación.

cancel

 Cancela una aprobación.

comment

 Comentarios sobre una aprobación

decline

 Rechaza una aprobación.

get

 Obtiene una aprobación por ID.

list

 Enumera las aprobaciones de un archivo.

reassign

 Reasigna los revisores de una aprobación.

start

 Inicia una aprobación en un archivo.