Method: comments.list

Отображает комментарии к файлу. Дополнительную информацию см. в разделе «Управление комментариями и ответами» .

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

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
includeDeleted

boolean

Включать ли удалённые комментарии. Удалённые комментарии не будут содержать своего первоначального содержимого.

pageSize

integer

Максимальное количество комментариев, которое может быть возвращено. Сервис может вернуть меньшее значение.

Если не указано иное, будет получено не более 20 комментариев.

Максимальное значение — 100; значения выше 100 будут принудительно уменьшены до 100.

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

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