Comments: insert

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

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

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

Запрос

HTTP-запрос

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

Авторизация

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

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

Параметры

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

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

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

Тело запроса

Укажите ресурс комментария в теле запроса. Для этого ресурса:

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

    • snippet.textOriginal
    • snippet.parentId

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

    • snippet.textOriginal

Ответ

В случае успеха этот метод возвращает ресурс комментария в теле ответа.

Ошибки

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

Тип ошибки Детализация ошибки Описание
badRequest (400) commentTextRequired Вставляемый ресурс comment должен указать значение свойства snippet.textOriginal . Комментарии не могут быть пустыми.
badRequest (400) commentTextTooLong Вставляемый ресурс comment содержит слишком много символов в свойстве snippet.textOriginal .
badRequest (400) invalidCustomEmoji Вставляемый ресурс comment содержит недопустимые пользовательские эмодзи.
badRequest (400) invalidCommentMetadata Метаданные запроса недействительны.
badRequest (400) operationNotSupported Пользователь API не может вставить комментарий в ответ на комментарий верхнего уровня, определенный свойством snippet.parentId . В ресурсе commentThread свойство snippet.canReply указывает, может ли текущий зритель ответить на ветку.
badRequest (400) parentCommentIsPrivate Указанный родительский комментарий является частным. API не поддерживает ответы на частные комментарии.
badRequest (400) parentIdMissing Вставляемый комментарий должен быть связан с родительским комментарием. Однако ресурс comment в теле запроса API не указал значение свойства snippet.parentId .
badRequest (400) processingFailure Серверу API не удалось успешно обработать запрос. Хотя это может быть временная ошибка, обычно она указывает на то, что ввод запроса недействителен. Проверьте структуру ресурса comment в теле запроса, чтобы убедиться, что она действительна.
forbidden (403) forbidden Комментарий не может быть создан из-за недостаточных разрешений. Возможно, запрос не авторизован должным образом.
forbidden (403) ineligibleAccount Учетная запись YouTube, используемая для авторизации запроса API, должна быть объединена с учетной записью Google пользователя, чтобы вставить комментарий или ветку комментариев.
notFound (404) parentCommentNotFound Указанный родительский комментарий не найден. Проверьте значение свойства snippet.parentId в тексте запроса, чтобы убедиться в его правильности.

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

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