Comments: setModerationStatus

Устанавливает статус модерации для одного или нескольких комментариев. Запрос к API должен быть авторизован владельцем канала или видео, с которым связаны комментарии.

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

Примеры использования

Запрос

HTTP-запрос

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

Авторизация

Для выполнения этого запроса требуется авторизация как минимум в одной из следующих областей доступа. Подробнее…

Область действия
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

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

Параметры
Обязательные параметры
id string
Параметр id содержит список до 50 идентификаторов комментариев, для которых вы хотите изменить статус модерации.
moderationStatus string
Новый статус модерации указанных комментариев.

Допустимые значения:
  • heldForReview – помечает комментарий как ожидающий проверки модератором.
  • published – комментарий будет опубликован. Нельзя изменить статус модерации отклоненного комментария на published.
  • rejected – отклонить комментарий как неприемлемый для показа. При этом все ответы на него также будут скрыты. Чтобы удалить комментарий другого пользователя со своего канала или из своего видео, установите для него статус модерации rejected. Метод comments.delete может использовать только автор комментария.
Необязательные параметры
banAuthor boolean
Параметр banAuthor позволяет указать, что вы хотите автоматически отклонять любые дополнительные комментарии, написанные автором комментария. Чтобы заблокировать автора, задайте для параметра значение true.

Этот параметр действителен, только если для параметра moderationStatus задано значение rejected.

Тело запроса

При вызове этого метода не указывайте тело запроса.

Ответ

Если запрос выполнен успешно, метод возвращает код ответа HTTP 204 (No Content).

Ошибки

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

Тип ошибки Сведения об ошибке Описание
badRequest (400) banWithoutReject Параметр banAuthor можно использовать, только если для параметра moderationStatus задано значение rejected.
badRequest (400) operationNotSupported Комментарии, не связанные с Google+, можно модерировать только в ограниченном режиме.
badRequest (400) processingFailure Серверу API не удалось обработать запрос. Это может быть временная ошибка, но обычно она указывает на то, что входные данные запроса недействительны. Эта ошибка также возвращается при попытке модерировать комментарий, который уже был удален его автором.
forbidden (403) forbidden Не удалось задать статус модерации для одного или нескольких комментариев из-за недостаточных разрешений. Возможно, у вас нет прав на выполнение запроса. Эта ошибка также возвращается при попытке модерировать удаленный или недействительный идентификатор комментария.
notFound (404) commentNotFound Один или несколько комментариев, которые вы пытаетесь изменить, не найдены. Проверьте значения параметра id в запросе.

Попробовать

Используйте APIs Explorer, чтобы вызвать этот API и посмотреть запрос к API и ответ.