Gerenciar aprovações

Este documento explica como gerenciar aprovações na API Google Drive.

Você pode encontrar as aprovações de conteúdo no Google Drive. A API Google Drive fornece o recurso approvals para que você possa receber e listar o status das suas aprovações. Os métodos do recurso approvals funcionam em itens do Drive, do Google Docs e de outros editores do Google Workspace.

Você pode usar esse processo para localizar aprovações em situações de revisão formal, como uma revisão de contrato ou um documento oficial antes da publicação. Uma aprovação acompanha o status da revisão (como "Em andamento", "Aprovada" ou "Recusada") e os revisores envolvidos. As aprovações são uma excelente maneira de validar conteúdo e manter um registro de revisores.

Para ver as aprovações em um arquivo, é necessário ter permissão para ler os metadados dele. Para mais informações, consulte Papéis e permissões.

Usar o parâmetro "fields"

Se você quiser especificar os campos a serem retornados na resposta, defina o parâmetro do sistema fields com qualquer método do recurso approvals. Se você omitir o parâmetro fields, o servidor vai retornar um conjunto padrão de campos específicos do método. Para retornar campos diferentes, consulte Retornar campos específicos.

Receber uma aprovação

Para receber uma aprovação em um arquivo, use o método get no recurso approvals com os parâmetros de caminho fileId e approvalId. Se você não souber o ID da aprovação, liste as aprovações usando o método list.

O corpo da resposta contém uma instância do recurso approvals.

Listar aprovações

Para listar aprovações em um arquivo, chame o método list no recurso approvals e inclua o parâmetro de caminho fileId.

O corpo da resposta consiste em uma lista de aprovações no arquivo. O campo items inclui informações sobre cada aprovação na forma de um recurso approvals.

O recurso approvals também inclui um objeto Status que detalha o status da aprovação, bem como o objeto ReviewerResponse que detalha a resposta a uma aprovação feita por um revisor específico. A resposta do revisor é representada pelo objeto Response.

Também é possível transmitir os seguintes parâmetros de consulta para personalizar a paginação ou filtrar as aprovações:

  • pageSize: o número máximo de aprovações a serem retornadas por página. Se você não definir pageSize, o servidor vai retornar até 100 aprovações.

  • pageToken: um token de página recebido de uma chamada de lista anterior. Esse token é usado para recuperar a página seguinte. Ele precisa ser definido como o valor de nextPageToken de uma resposta anterior.