Comments

Ресурс comment содержит информацию об одном комментарии YouTube. Ресурс comment может представлять собой комментарий к видео или каналу. Кроме того, комментарий может быть комментарием верхнего уровня или ответом на комментарий верхнего уровня.

Методы

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

list

Возвращает список комментариев, соответствующих параметрам запроса API. Попробуйте сейчас .

insert

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

update

Изменяет комментарий. Попробуйте сейчас .

delete

Удаляет комментарий. Попробуйте сейчас .

setModerationStatus

Устанавливает статус модерации одного или нескольких комментариев. Запрос API должен быть авторизован владельцем канала или видео, связанного с комментариями. Попробуйте сейчас .

markAsSpam

Примечание. Этот метод устарел и больше не поддерживается.

Выражает мнение вызывающего абонента о том, что один или несколько комментариев следует пометить как спам.

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

Следующая структура JSON показывает формат ресурса comments :

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

Характеристики

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

Характеристики
kind	string Идентифицирует тип ресурса API. Значением будет youtube#comment .
etag	etag Этаг этого ресурса.
id	string Идентификатор, который YouTube использует для уникальной идентификации комментария.
snippet	object Объект snippet содержит основные сведения о комментарии.
snippet. authorDisplayName	string Отображаемое имя пользователя, разместившего комментарий.
snippet. authorProfileImageUrl	string URL-адрес аватара пользователя, разместившего комментарий.
snippet. authorChannelUrl	string URL-адрес канала автора комментария на YouTube, если он доступен.
snippet. authorChannelId	object Этот объект инкапсулирует информацию о канале YouTube автора комментария, если он доступен.
snippet.authorChannelId. value	string Идентификатор YouTube-канала автора комментария, если имеется.
snippet. channelId	string Идентификатор канала YouTube, связанного с комментарием. Если комментарий является комментарием канала, то это свойство идентифицирует канал, к которому относится комментарий.
snippet. textDisplay	string Текст комментария. Текст можно получить либо в виде обычного текста, либо в формате HTML. (Оба метода comments.list и commentThreads.list поддерживают параметр textFormat , который указывает желаемый текстовый формат.) Обратите внимание, что даже простой текст может отличаться от исходного текста комментария. Например, он может заменять ссылки на видео названиями видео.
snippet. textOriginal	string Исходный необработанный текст комментария в том виде, в котором он был первоначально опубликован или последний раз обновлен. Исходный текст возвращается только в том случае, если он доступен аутентифицированному пользователю, что гарантируется только в том случае, если пользователь является автором комментария.
snippet. parentId	string Уникальный идентификатор родительского комментария. Это свойство устанавливается только в том случае, если комментарий был отправлен как ответ на другой комментарий.
snippet. canRate	boolean Этот параметр указывает, может ли текущий зритель оценить комментарий.
snippet. viewerRating	string Рейтинг, который зритель дал этому комментарию. Обратите внимание, что это свойство в настоящее время не определяет рейтинг dislike , хотя это поведение может быть изменено. В то же время значение свойства like , как если бы зритель оценил комментарий положительно. Во всех остальных случаях значение равно none , включая то, что пользователь поставил комментарию отрицательную оценку или не поставил ему оценку. Допустимые значения для этого свойства: like none
snippet. likeCount	unsigned integer Общее количество лайков (положительных оценок), полученных комментарием.
snippet. moderationStatus	string Статус модерации комментария. Это свойство возвращается только в том случае, если запрос API был авторизован владельцем канала или видео, к которому были сделаны запрошенные комментарии. Кроме того, обратите внимание, что это свойство не устанавливается, если в запросе API использовался параметр фильтра id . Допустимые значения для этого свойства: heldForReview likelySpam published rejected
snippet. publishedAt	datetime Дата и время первоначальной публикации комментария. Значение указывается в формате ISO 8601 .
snippet. updatedAt	datetime Дата и время последнего обновления комментария. Значение указывается в формате ISO 8601 .