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 и ответ.