Borra un mensaje de chat. 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/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 |
string El parámetro id especifica el ID del mensaje de chat de YouTube del recurso que se borrará. |
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 tienes los permisos necesarios para borrar el mensaje especificado. |
forbidden (403) |
modificationNotAllowed |
No se puede borrar el recurso liveChatMessage especificado. El parámetro id puede identificar un mensaje creado por un moderador o algún otro usuario cuyos mensajes no se puedan borrar. |
notFound (404) |
liveChatMessageNotFound |
No se puede encontrar el mensaje que intentas eliminar. Comprueba el valor del parámetro id para asegurarte de que sea correcto. |
Pruébela.
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.