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 Этаг этого ресурса.
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 , чтобы идентифицировать комментарий, для которого вы хотите получить ответы.