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,
    "imageUrl": string
  }
}

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

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

Характеристики
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 .
snippet. imageUrl string
URL изображения или анимированного GIF-файла, прикрепленного к комментарию, если таковой имеется. Это свойство присутствует только в том случае, если комментарий содержит изображение или GIF-файл. URL-адрес предоставляется в виде подписанной ссылки с шестичасовым временем жизни (TTL) и истекает через шесть часов после получения.