CommentThreads

Ресурс commentThread содержит информацию о цепочке комментариев YouTube, которая состоит из комментария верхнего уровня и ответов на него (если они есть). Ресурс commentThread представляет комментарии к видео.

Комментарии верхнего уровня и ответы на них – это ресурсы comment, вложенные в ресурс commentThread. Ресурс commentThread не обязательно содержит все ответы на комментарий. Чтобы получить все ответы на определенный комментарий, используйте метод comments.list. Некоторые комментарии не имеют ответов.

Методы

API поддерживает следующие методы для ресурсов commentThreads:

list
Возвращает список цепочек комментариев, соответствующих параметрам запроса к API. Перейти
insert
Создает новый комментарий верхнего уровня. Чтобы добавить ответ на существующий комментарий, используйте метод comments.insert. Попробовать

Представление ресурса

Структура JSON показывает формат ресурса commentThreads:

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

Свойства

В таблице ниже приведены свойства, которые используются в этом ресурсе.

Свойства
kind string
Тип ресурса API. Значение будет youtube#commentThread.
etag etag
Тег ETag этого ресурса.
id string
Идентификатор, который YouTube использует для уникальной идентификации цепочки комментариев.
snippet object
Объект snippet содержит основные сведения о цепочке комментариев. Он также содержит комментарий верхнего уровня, который является ресурсом comment.
snippet.channelId string
Канал YouTube, связанный с комментариями в цепочке. Свойство snippet.videoId позволяет идентифицировать видео.
snippet.videoId string
Идентификатор видео, к которому относятся комментарии.
snippet.topLevelComment object
Комментарий верхнего уровня в цепочке. Значение свойства – ресурс comment.
snippet.canReply boolean
Этот параметр указывает, может ли текущий пользователь отвечать на сообщения в цепочке.
snippet.totalReplyCount unsigned integer
Общее количество ответов на комментарий верхнего уровня.
snippet.isPublic boolean
Этот параметр определяет, видна ли цепочка комментариев, включая все ответы, всем пользователям YouTube.
replies object
Объект replies – это контейнер, в котором содержится список ответов на комментарий (если они есть). Свойство replies.comments представляет собой список комментариев.
replies.comments[] list
Список ответов на комментарий верхнего уровня. Каждый элемент в списке представляет собой ресурс comment.

Список содержит ограниченное количество ответов. Если количество элементов в списке не равно значению свойства snippet.totalReplyCount, то список ответов является лишь подмножеством общего количества ответов, доступных для комментария верхнего уровня. Чтобы получить все ответы на комментарий верхнего уровня, вызовите метод comments.list и укажите в параметре parentId идентификатор комментария, ответы на который вы хотите получить.