Method: approvals.reassign

Reatribui os revisores em uma aprovação. Adiciona ou substitui revisores no ReviewerResponse da aprovação.

Isso pode ser chamado por qualquer usuário com a permissão writer no arquivo enquanto a Status de aprovação for IN_PROGRESS e o Response do revisor que está sendo reatribuído for NO_RESPONSE. Um usuário com a permissão reader só pode reatribuir uma aprovação que foi atribuída a ele mesmo.

Não é permitido remover um revisor.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
fileId

string

Obrigatório. O ID do arquivo em que a aprovação está.

approvalId

string

Obrigatório. O ID da aprovação a ser reatribuída.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "addReviewers": [
    {
      object (AddReviewer)
    }
  ],
  "replaceReviewers": [
    {
      object (ReplaceReviewer)
    }
  ],
  "message": string
}
Campos
addReviewers[]

object (AddReviewer)

Opcional. A lista de revisores a serem adicionados.

replaceReviewers[]

object (ReplaceReviewer)

Opcional. A lista de substituições de revisores.

message

string

Opcional. Uma mensagem para enviar aos novos revisores. Essa mensagem será incluída nas notificações da ação e no registro de atividades de aprovação.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Approval.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Alguns escopos são restritos e exigem uma avaliação de segurança para que o app possa usá-los. Para mais informações, consulte o guia de autorização.

AddReviewer

Representação da adição de um revisor.

Representação JSON
{
  "addedReviewerEmail": string
}
Campos
addedReviewerEmail

string

Obrigatório. O e-mail do revisor a ser adicionado.

ReplaceReviewer

Representação de uma substituição de revisor.

Representação JSON
{
  "addedReviewerEmail": string,
  "removedReviewerEmail": string
}
Campos
addedReviewerEmail

string

Obrigatório. O e-mail do revisor a ser adicionado.

removedReviewerEmail

string

Obrigatório. O e-mail do revisor a ser removido.