Удаляет запрет, который не позволяет конкретному пользователю участвовать в чате, тем самым позволяя пользователю повторно присоединиться к чату. Запрос API должен быть авторизован владельцем канала или модератором чата, связанного с баном.
Распространенные случаи использования
Запрос
HTTP-запрос
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
Авторизация
Для этого запроса требуется авторизация хотя бы с одной из следующих областей. Дополнительные сведения об аутентификации и авторизации см. в разделе «Реализация аутентификации OAuth 2.0» .
Объем |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Параметры
В следующей таблице перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.
Параметры | ||
---|---|---|
Обязательные параметры | ||
id | string Параметр id определяет бан чата, который нужно снять. Значение однозначно идентифицирует как бан, так и чат. |
Тело запроса
Не указывайте тело запроса при вызове этого метода.
Ответ
В случае успеха этот метод возвращает код состояния HTTP 204 No Content
.
Ошибки
В следующей таблице указаны сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Более подробную информацию см. в сообщении об ошибке .
Тип ошибки | Детализация ошибки | Описание |
---|---|---|
forbidden (403) | forbidden | Указанный бан невозможно снять. Данная ошибка может возникнуть, если запрос авторизован одним модератором, который пытается снять бан с другого модератора. |
forbidden (403) | insufficientPermissions | У вас нет необходимых разрешений для снятия указанного бана. |
invalidValue (400) | invalidLiveChatBanId | Параметр id указывает недопустимое значение. |
notFound (404) | liveChatBanNotFound | Указанный бан не найден. |
Попробуй это!
Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.