Method: comments.list

Lista os comentários de um arquivo. Para mais informações, consulte Gerenciar comentários e respostas.

Obrigatório: o parâmetro fields precisa ser definido. 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}/comments

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

Parâmetros de caminho

Parâmetros
fileId

string

O ID do arquivo.

Parâmetros de consulta

Parâmetros
includeDeleted

boolean

Se os comentários excluídos serão incluídos. Os comentários excluídos não incluem o conteúdo original.
pageSize

integer

O número máximo de comentários a serem retornados. O serviço pode retornar um valor inferior a este.

Se não for especificado, no máximo 20 comentários serão retornados.

O valor máximo é 100. Valores acima de 100 serão forçados para 100.
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" da resposta anterior.
startModifiedTime

string

O valor mínimo de "modifiedTime" para os comentários de resultado (data e hora RFC 3339).

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de comentários em um arquivo.

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

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

object (Comment)

A lista de comentários. Se nextPageToken for preenchido, essa lista poderá estar incompleta e uma página adicional de resultados precisará ser buscada.
kind

string

Identifica o tipo de recurso. Valor: a string fixa "drive#commentList".
nextPageToken

string

O token da página para a próxima página de comentários. Ele estará ausente se o final da lista de comentários 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. O token da página normalmente é válido por várias horas. No entanto, se novos itens forem adicionados ou removidos, os resultados esperados poderão ser diferentes.

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.meet.readonly
  • https://www.googleapis.com/auth/drive.readonly

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