Borra un mensaje de chat. El propietario del canal o un moderador del chat en vivo asociado con la prohibición deben autorizar la solicitud a la API.
Impacto en la cuota: Una llamada a este método tiene un costo de cuota de 20 unidades.
Casos de uso habituales
Solicitud
Solicitud HTTP
DELETE https://www.googleapis.com/youtube/v3/liveChat/messages
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 especifica el ID del mensaje de chat de YouTube del recurso que se está borrando. |
|
Cuerpo de la solicitud
No proporciones un cuerpo de solicitud cuando invoques este método.
Respuesta
Si se ejecuta 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 de los mensajes de error para obtener más detalles.
| Tipo de error | Detalle del error | Descripción |
|---|---|---|
forbidden (403) |
forbidden |
No tienes los permisos necesarios para borrar el mensaje especificado. |
forbidden (403) |
modificationNotAllowed |
No se puede borrar el recurso liveChatMessage especificado. El parámetro id podría identificar un mensaje creado por un moderador o por otro usuario cuyos mensajes no se pueden borrar. |
notFound (404) |
liveChatMessageNotFound |
No se puede encontrar el mensaje que intentas borrar. Verifica el valor del parámetro id para asegurarte de que sea correcto. |
Pruébalo
Usa el APIs Explorer para llamar a esta API y ver la solicitud a la API y la respuesta.