Method: approvals.list

Lista as aprovações em um arquivo. Para mais informações, consulte Gerenciar aprovações.

Por padrão, esse método retorna uma resposta mínima que pode não incluir a matriz items. Para recuperar os detalhes da aprovação, especifique explicitamente os campos desejados usando o parâmetro de consulta fields. Para retornar os campos exatos de que você precisa, consulte Retornar campos específicos.

Solicitação HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/approvals

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á.

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de aprovações a serem retornadas. Quando não definido, no máximo 100 aprovações são retornadas.

pageToken

string

O token para continuar uma solicitação de lista anterior na próxima página. Ele precisa ser definido como o valor de nextPageToken de uma resposta anterior.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

A resposta de uma solicitação de lista de aprovações.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "kind": string,
  "items": [
    {
      object (Approval)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

É sempre drive#approvalList

items[]

object (Approval)

A lista de aprovações. Se nextPageToken estiver preenchido, essa lista poderá estar incompleta e uma página adicional de resultados precisará ser buscada.

nextPageToken

string

O token de página para a próxima página de aprovações. Ele estará ausente se o final da lista de aprovações tiver sido atingido. Se o token for rejeitado por qualquer motivo, ele precisará ser descartado, e a paginação precisará ser reiniciada na primeira página de resultados.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Alguns escopos são restritos e exigem uma avaliação de segurança para que seu app os use. Para mais informações, consulte o guia de autorização.