REST Resource: approvals

Recurso: Approval

Metadados de uma aprovação. Uma aprovação é um processo de revisão ou aprovação de um item do Drive.

Representação 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

É sempre drive#approval.
approvalId

string

O ID da aprovação.
targetFileId

string

ID do arquivo de destino da aprovação.
createTime

string (Timestamp format)

Apenas saída. O horário em que a aprovação foi criada.

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".
modifyTime

string (Timestamp format)

Apenas saída. A última vez que a aprovação foi modificada.

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".
completeTime

string (Timestamp format)

Apenas saída. O horário em que a aprovação foi concluída.

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".
dueTime

string (Timestamp format)

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".
status

enum (Status)

Apenas saída. O status da aprovação no momento em que este recurso foi solicitado.
initiator

object (User)

O usuário que solicitou a aprovação.
reviewerResponses[]

object (ReviewerResponse)

As respostas dadas na aprovação pelos revisores.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

Apenas saída. O comportamento da aprovação quando o conteúdo do arquivo muda.

Status

Status possíveis de uma aprovação.

Tipos enumerados
STATUS_UNSPECIFIED O status de aprovação não foi definido ou foi definido com um valor inválido.
IN_PROGRESS O processo de aprovação foi iniciado, mas não concluído.
APPROVED O processo de aprovação foi concluído e o destino foi aprovado.
CANCELLED O processo de aprovação foi cancelado antes da conclusão.
DECLINED O processo de aprovação foi concluído e o destino foi recusado.

ReviewerResponse

Uma resposta sobre uma aprovação feita por um revisor específico.

Representação JSON 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
Campos
kind

string

É sempre drive#reviewerResponse.
reviewer

object (User)

O usuário responsável por esta resposta.
response

enum (Response)

A resposta de um revisor para a aprovação.

Resposta

Possíveis respostas para uma aprovação.

Tipos enumerados
RESPONSE_UNSPECIFIED A resposta foi definida como um valor não reconhecido.
NO_RESPONSE O avaliador não respondeu.
APPROVED O revisor aprovou o item.
DECLINED O revisor recusou o item.

FileContentChangeBehavior

O comportamento da aprovação quando o conteúdo do arquivo muda enquanto o [Status][] da aprovação é IN_PROGRESS. Esse comportamento não ocorre mais depois que a aprovação é concluída.

Tipos enumerados
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED O comportamento não é especificado.
RESET_APPROVAL Qualquer ReviewerResponse com um Response de APPROVED será redefinido como NO_DECISION quando o conteúdo do arquivo mudar enquanto a aprovação tiver um [Status][] de IN_PROGRESS. Quando a aprovação tem um [Status][] de APPROVED e RESET_APPROVAL é selecionado, o arquivo fica bloqueado.
NO_APPROVAL_ACTION Nenhuma ação é realizada quando o conteúdo do arquivo muda.

Métodos

approve

 Aprova uma aprovação.

cancel

 Cancela uma aprovação.

comment

 Comentários em uma aprovação.

decline

 Recusa uma aprovação.

get

 Recebe uma aprovação por ID.

list

 Lista as aprovações em um arquivo.

reassign

 Reatribui os revisores em uma aprovação.

start

 Inicia uma aprovação em um arquivo.