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.topLevelComment.snippet.textOriginal

  • Вы можете установить значения для этих свойств:

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

Ответ

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

Ошибки

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

Тип ошибки Сведения об ошибке Описание
badRequest (400) channelOrVideoIdMissing Каждая ветка комментариев должна быть связана с каналом или видео.
  • Если комментарий относится к каналу, убедитесь, что ресурс, указанный в тексте запроса, предоставляет значение для свойства snippet.channelId . Комментарий, относящийся к каналу, отображается на вкладке «Обсуждение» канала.
  • Если комментарий относится к видео, убедитесь, что в ресурсе указаны значения для свойств 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.