Agrega un mensaje a un chat en vivo. Actualmente, la API solo admite la inserción de mensajes de texto.
Casos de uso habituales
Solicitud
Solicitud HTTP
POST 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 | ||
part |
string El parámetro part tiene dos propósitos. Identifica las propiedades que establecerá la operación de escritura, así como las propiedades que incluirá la respuesta de la API. Establece el valor del parámetro en snippet . |
Cuerpo de la solicitud
Proporciona un recurso liveChatMessage en el cuerpo de la solicitud. Para ese recurso:
-
Debes especificar un valor para estas propiedades:
snippet.liveChatId
snippet.type
: Actualmente, el único valor admitido estextMessageEvent
.snippet.textMessageDetails.messageText
Respuesta
Si se aplica correctamente, este método muestra un recurso liveChatMessage en el cuerpo de la respuesta.
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 crear el mensaje especificado. |
forbidden (403) |
liveChatDisabled |
El propietario inhabilitó el chat en vivo que especificaste, lo que significa que no se pueden agregar mensajes al chat. |
forbidden (403) |
liveChatEnded |
El chat en vivo que especificaste ya no está en vivo. |
invalidValue (400) |
messageTextInvalid |
El texto del mensaje (snippet.textMessageDetails.messageText ) no es válido. |
notFound (404) |
liveChatNotFound |
El chat en vivo identificado en la solicitud a la API no existe. Este error se produce si el propietario borró el chat. |
rateLimitExceeded |
rateLimitExceeded |
El usuario ha publicado demasiados mensajes de chat en un período de tiempo determinado. |
required (400) |
liveChatIdRequired |
El recurso liveChatMessage debe incluir y especificar un valor para la propiedad snippet.liveChatId . |
required (400) |
messageTextRequired |
El recurso liveChatMessage debe incluir y especificar un valor para la propiedad snippet.textMessageDetails.messageText . |
required (400) |
typeRequired |
El recurso liveChatMessage debe incluir y especificar un valor para la propiedad snippet.type . Establece el valor del parámetro en text |
Pruébela.
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.