Method: comments.list

Перечисляет комментарии к файлу.

HTTP-запрос

GET https://www.googleapis.com/drive/v2/files/{fileId}/comments

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
fileId

string

Идентификатор файла.

Параметры запроса

Параметры
includeDeleted

boolean

Если установлено, все комментарии и ответы, включая удаленные комментарии и ответы (с удаленным содержимым), будут возвращены.

maxResults

integer

Максимальное количество обсуждений, включаемых в ответ, используемое для пейджинга.

pageToken

string

Токен продолжения, используемый для постраничного просмотра больших наборов результатов. Чтобы получить следующую страницу результатов, установите для этого параметра значение «nextPageToken» из предыдущего ответа.

updatedMin

string

Будут возвращены только те обсуждения, которые были обновлены после этой отметки времени. Отформатировано как временная метка RFC 3339.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Список комментариев к файлу на Google Диске.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "kind": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Поля
kind

string

Это всегда drive#commentList .

items[]

object ( Comment )

Список комментариев. Если параметр nextPageToken заполнен, этот список может быть неполным и необходимо получить дополнительную страницу результатов.

nextPageToken

string

Токен страницы для следующей страницы комментариев. Это будет отсутствовать, если достигнут конец списка комментариев. Если токен отклонен по какой-либо причине, его следует отбросить и перезапустить нумерацию страниц с первой страницы результатов.

Области авторизации

Требуется одна из следующих областей 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.readonly

Некоторые области ограничены, и для их использования требуется оценка безопасности вашего приложения. Дополнительную информацию см. в руководстве по авторизации .