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 .