Method: comments.list

Lista os comentários de um arquivo.

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 por página.
pageToken

string

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

string

O valor mínimo de "modifyTime" nos comentários do resultado (RFC 3339, data-hora).

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 
{
  "kind": string,
  "comments": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Identifica o tipo de recurso. Valor: a string fixa "drive#commentList".
comments[]

object (Comment)

A lista de comentários. Se nextPageToken for preenchida, essa lista poderá estar incompleta, e outra página de resultados deverá ser buscada.
nextPageToken

string

O token da próxima página de comentários. Essa opção não aparece quando o fim da lista de comentários é alcançado. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado e a paginação deverá ser reiniciada na primeira página de resultados. O token de página costuma ser 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 serem usados pelo app. Para mais informações, consulte o Guia de autorização.