Comments

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

Методы

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

list
Возвращает список комментариев, соответствующих параметрам API-запроса. Попробуйте сейчас .
insert
Создаёт ответ на существующий комментарий. Примечание: чтобы создать комментарий верхнего уровня, используйте метод commentThreads.insert . Попробуйте прямо сейчас .
update
Изменяет комментарий. Попробуйте сейчас .
delete
Удаляет комментарий. Попробуйте сейчас .
setModerationStatus
Устанавливает статус модерации одного или нескольких комментариев. API-запрос должен быть авторизован владельцем канала или видео, связанного с комментариями. Попробуйте сейчас .

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

Следующая структура 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
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 .