CommentThreads: insert

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

Влияние квоты. Стоимость вызова этого метода составляет 50 единиц.

Распространенные случаи использования

Запрос

HTTP-запрос

POST https://www.googleapis.com/youtube/v3/commentThreads

Авторизация

Этот запрос требует авторизации хотя бы в одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

Объем
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

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

Параметры
Обязательные параметры
part string
Параметр part определяет свойства, которые будет включать ответ API. Установите значение параметра snippet . snippet часть имеет квотную стоимость в 2 единицы.

Следующий список содержит названия part , которые можно включить в значение параметра:
  • id
  • replies
  • snippet

Тело запроса

Укажите ресурс commentThread в теле запроса.

Для этого ресурса необходимо указать значение для следующих свойств:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Ответ

В случае успеха этот метод возвращает ресурс commentThread в теле ответа.

Ошибки

В следующей таблице указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Дополнительные сведения см. в документации по сообщениям об ошибках .

Тип ошибки Детализация ошибки Описание
badRequest (400) channelOrVideoIdMissing Каждая ветка комментариев должна быть связана с видео. Убедитесь, что ресурс указывает значения свойств snippet.channelId и snippet.videoId . Комментарий к видео появляется на странице просмотра видео.
badRequest (400) commentTextRequired Вставляемый ресурс comment должен указать значение свойства snippet.topLevelComment.snippet.textOriginal . Комментарии не могут быть пустыми.
badRequest (400) commentTextTooLong Вставляемый ресурс comment содержит слишком много символов в свойстве snippet.topLevelComment.snippet.textOriginal .
badRequest (400) invalidCommentThreadMetadata Метаданные запроса недействительны.
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен. Проверьте структуру ресурса commentThread в теле запроса, чтобы убедиться, что она действительна.
forbidden (403) forbidden Не удалось создать ветку комментариев из-за недостаточных разрешений. Возможно, запрос не авторизован должным образом.
forbidden (403) ineligibleAccount Учетная запись YouTube, используемая для авторизации запроса API, должна быть объединена с учетной записью Google пользователя, чтобы вставить комментарий или ветку комментариев.
notFound (404) channelNotFound Указанный канал не найден. Проверьте значение свойства snippet.channelId , чтобы убедиться в его правильности.
notFound (404) videoNotFound Указанное видео не найдено. Проверьте значение свойства snippet.videoId , чтобы убедиться в его правильности.

Попробуй это!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.