Cambia el estado de un mensaje del chat en vivo de YouTube e inicia cualquier proceso asociado con el estado nuevo. Por ejemplo, cuando cambias el estado de una encuesta en vivo a closed
, YouTube finaliza la encuesta de ese mensaje. Antes de llamar a este método, debes confirmar que el valor de la propiedad status
del mensaje de la encuesta publicado sea active
.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition
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 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 especifica el ID único del mensaje que está cambiando a otro estado. |
|
status |
enum El parámetro status identifica el estado al que cambia el mensaje. Para hacer la transición de un mensaje al estado closed , el status debe ser active para la encuesta a la que está vinculado el mensaje.
Solo puedes realizar la transición a closed , lo que significa que la encuesta está cerrada.
|
|
Parámetros opcionales | ||
part |
string El parámetro part especifica las partes del recurso liveChatMessage que incluirá la respuesta de la API. Los valores admitidos son id , snippet y authorDetails .
Establece el valor del parámetro en snippet para obtener el resultado final de la encuesta en el cuerpo de la respuesta.
|
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 recurso liveChatMessages 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 realizar la transición del estado del mensaje especificado. |
required (400) |
idRequired |
El parámetro obligatorio id debe identificar el mensaje cuyo estado deseas cambiar. |
required (400) |
statusRequired |
La solicitud a la API debe especificar un valor para el parámetro status . |
notFound (404) |
liveChatMessagesNotFound |
El mensaje especificado por el parámetro id no existe. |
forbidden (403) |
modificationNotAllowed |
No se puede realizar la transición del estado del recurso liveChatMessage especificado. El parámetro id podría identificar un mensaje cuyo estado no se puede cambiar. |
Pruébalo
Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.