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)

Solo salida. Fecha y hora en 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 fecha y hora más recientes en 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 fecha y 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 fecha y hora en 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 dieron en la aprobación.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Solo salida. 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 Se completó el proceso de aprobación y se aprobó el objetivo.
CANCELLED Se canceló el proceso de aprobación antes de que finalizara.
DECLINED Finalizó el proceso de aprobación 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

Son las posibles respuestas 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.

FileContentChangeBehavior

Es el comportamiento de la aprobación cuando cambia el contenido del archivo mientras el [Estado][] de la 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 el [Estado][] de APROBADO 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 en una aprobación.

start

 Inicia una aprobación en un archivo.