Method: comments.list

Список комментариев к файлу. Подробнее см. в разделе Управление комментариями и ответами .

Обязательно: необходимо задать параметр fields . Чтобы вернуть нужные поля, см. раздел «Возврат определённых полей» .

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
includeDeleted

boolean

Включать ли удалённые комментарии? Удалённые комментарии не будут содержать их исходный контент.

pageSize

integer

Максимальное количество комментариев, возвращаемых на страницу.

pageToken

string

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

startModifiedTime

string

Минимальное значение «modifiedTime» для комментариев к результату (дата-время RFC 3339).

Текст запроса

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

Тело ответа

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

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

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

object ( Comment )

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

kind

string

Определяет тип ресурса. Значение: фиксированная строка "drive#commentList" .

nextPageToken

string

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

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

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

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