Quita el bloqueo que impide que un usuario específico contribuya al chat en vivo, lo que le permite volver a unirse. El propietario del canal o un moderador del chat en vivo asociado con el bloqueo debe autorizar la solicitud a la API.
Casos de uso habituales
Solicitud
Solicitud HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/bans
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).
| Alcance |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parámetros
En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.
| Parámetros | ||
|---|---|---|
| Parámetros obligatorios | ||
id |
stringEl parámetro id identifica el bloqueo del chat que se quitará. El valor identifica de forma exclusiva el bloqueo y el chat. |
|
Cuerpo de la solicitud
No proporciones un cuerpo de solicitud cuando invoques este método.
Respuesta
Si se aplica correctamente, este método muestra un código de respuesta HTTP 204 (No Content).
Errores
En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.
| Tipo de error | Detalle del error | Descripción |
|---|---|---|
forbidden (403) |
forbidden |
No se puede quitar el bloqueo especificado. Este error puede ocurrir si la solicitud está autorizada por un moderador que intenta quitarle el bloqueo a otro moderador. |
forbidden (403) |
insufficientPermissions |
No tienes los permisos necesarios para quitar el bloqueo especificado. |
invalidValue (400) |
invalidLiveChatBanId |
El parámetro id especifica un valor no válido. |
notFound (404) |
liveChatBanNotFound |
No se puede encontrar el bloqueo especificado. |
Pruébalo
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta a la API.