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

object ( Comment )

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

kind

string

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

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

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