LiveChatBans: delete

Quita una prohibición que impide que un usuario específico contribuya a un chat en vivo, lo que le permite volver a unirse al chat. El propietario del canal o un moderador del chat en vivo asociado con la prohibición deben 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. 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 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 la prohibición del chat que se 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 ejecuta de forma correcta, 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 la prohibición especificada. Este error puede ocurrir si la solicitud la autoriza un moderador que intenta quitar una prohibición a otro moderador.
forbidden (403) insufficientPermissions No tienes los permisos necesarios para quitar la prohibición especificada.
invalidValue (400) invalidLiveChatBanId El parámetro id especifica un valor no válido.
notFound (404) liveChatBanNotFound No se puede encontrar la prohibición especificada.

Pruébalo

Usa el APIs Explorer para llamar a esta API y ver la solicitud a la API y la respuesta.