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

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