Quita un bloqueo que impide que un usuario específico contribuya a un chat en vivo para que pueda volver a unirse. La solicitud de la API debe ser autorizada por el propietario del canal o un moderador del chat en vivo asociado con la prohibición.
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 |
string El parámetro id identifica el bloqueo que se debe quitar. El valor identifica de forma única la prohibición 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 |
La prohibición especificada no se puede eliminar. Este error puede ocurrir si la solicitud está autorizada por un moderador que intenta eliminar una prohibición contra 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ébela.
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.