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.