Method: comments.list

Lista os comentários de um arquivo.

Solicitação HTTP

GET https://www.googleapis.com/drive/v2/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 definido, todos os comentários e respostas, incluindo os comentários e as respostas excluídos (com conteúdo removido), serão retornados.

maxResults

integer

O número máximo de discussões a serem incluídas na resposta, usada para paginação.

pageToken

string

O token de continuação, usado para percorrer conjuntos grandes de resultados. Para acessar a próxima página de resultados, defina esse parâmetro como o valor de "nextPageToken". da resposta anterior.

updatedMin

string

Somente as discussões que foram atualizadas depois desse carimbo de data/hora serão retornadas. Formatado como carimbo de data/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 no Google Drive.

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

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

string

É sempre drive#commentList.

items[]

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.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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