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-представление 
{
  "kind": string,
  "comments": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
Поля
kind

string

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

comments[]

object ( Comment )

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

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

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