Создает ответ на существующий комментарий. Примечание. Чтобы создать комментарий верхнего уровня, используйте метод 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 , которые можно включить в значение параметра:
|
Тело запроса
Укажите ресурс комментария в теле запроса. Для этого ресурса:
Вы должны указать значение для этих свойств:
-
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.