Эта страница переведена с помощью Cloud Translation API.

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 .