- HTTP-запрос
- Параметры пути
- Параметры запроса
- Текст запроса
- Ответный текст
- Области полномочий
- Попробуйте!
Выводит список комментариев к файлу.
HTTP-запрос
GET https://www.googleapis.com/drive/v2/files/{fileId}/comments
В URL-адресе используется синтаксис транскодирования gRPC .
Параметры пути
| Параметры | |
|---|---|
fileId | Идентификатор файла. |
Параметры запроса
| Параметры | |
|---|---|
includeDeleted | Если эта опция включена, будут возвращены все комментарии и ответы, включая удалённые комментарии и ответы (с удалённым содержимым). |
maxResults | Максимальное количество обсуждений, которые можно включить в ответ, используется для постраничного отображения. |
pageToken | Токен продолжения, используемый для постраничного просмотра больших наборов результатов. Чтобы получить следующую страницу результатов, установите для этого параметра значение "nextPageToken" из предыдущего ответа. |
updatedMin | Будут возвращены только обсуждения, обновленные после этой временной метки. Форматировано как временная метка RFC 3339. |
Текст запроса
Тело запроса должно быть пустым.
Ответный текст
Список комментариев к файлу в Google Диске.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"items": [
{
object ( |
| Поля | |
|---|---|
items[] | Список комментариев. Если поле nextPageToken заполнено, то этот список может быть неполным, и потребуется загрузить дополнительную страницу с результатами. |
kind | Это всегда drive#commentList. |
selfLink | Ссылка на этот список. |
nextLink | Ссылка на следующую страницу комментариев. |
nextPageToken | Токен страницы для перехода на следующую страницу комментариев. Он будет отсутствовать, если список комментариев завершен. Если токен отклонен по какой-либо причине, его следует удалить, и пагинация должна начаться заново с первой страницы результатов. |
Области полномочий
Требуется один из следующих диапазонов аутентификации 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
Некоторые области действия ограничены и требуют проведения оценки безопасности для их использования вашим приложением. Для получения дополнительной информации см. руководство по авторизации .