Elimina un bloqueo que impide que un usuario específico contribuya al chat en vivo, lo que le permite volver a unirse al chat. La solicitud a la API debe estar autorizada por el propietario del canal o un moderador del chat en vivo asociado con el bloqueo.
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. Para obtener más información sobre la autenticación y la autorización, consulta Cómo implementar la autenticación de OAuth 2.0.
Alcance |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parámetros
En la siguiente tabla, se indican 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 del chat que se debe quitar. El valor identifica de forma única tanto el bloqueo como 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 estado 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. Para obtener más detalles, consulta el mensaje de error.
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 eliminar el bloqueo de 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 de la API.