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

Тело запроса

В теле запроса укажите ресурс comment. Для этого ресурса:

  • Необходимо указать значение для следующих свойств:

    • snippet.textOriginal
    • snippet.parentId

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

    • snippet.textOriginal

Ответ

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

Ошибки

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

Тип ошибки Сведения об ошибке Описание
badRequest (400) commentTextRequired В добавляемом ресурсе comment должно быть указано значение свойства snippet.textOriginal. Комментарий не может быть пустым.
badRequest (400) commentTextTooLong В свойстве snippet.textOriginal добавляемого ресурса comment слишком много символов.
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 и ответ.