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