LiveChatMessages: transition

Modifica lo stato di un messaggio della chat live di YouTube e avvia tutti i processi associati al nuovo stato. Ad esempio, quando modifichi lo stato di un sondaggio live in closed, YouTube termina il sondaggio del messaggio. Prima di chiamare questo metodo, devi verificare che il valore della proprietà status del messaggio del sondaggio live sia active.

Impatto sulla quota: una chiamata a questo metodo ha un costo di quota di 20 unità.

Richiesta

Richiesta HTTP

POST https://www.googleapis.com/youtube/v3/liveChat/messages/transition

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).

Ambito
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametri

La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.

Parametri
Parametri obbligatori
id string
Il parametro id specifica l'ID univoco del messaggio di cui viene modificato lo stato.
status enum
Il parametro status identifica lo stato in cui viene modificato il messaggio. Per modificare lo stato di un messaggio in closed, il valore di status deve essere active per il sondaggio a cui è associato il messaggio.

Puoi modificare lo stato solo in closed, il che significa che il sondaggio è chiuso.
Parametri facoltativi
part string
Il parametro part specifica le parti della risorsa liveChatMessage che verranno incluse nella risposta dell'API. I valori supportati sono id, snippet e authorDetails.

Imposta il valore del parametro su snippet per ottenere il risultato finale del sondaggio nel corpo della risposta.

Corpo della richiesta

Non fornire un corpo della richiesta quando chiami questo metodo.

Risposta

Se l'operazione ha esito positivo, questo metodo restituisce una risorsa liveChatMessages nel corpo della risposta.

Errori

La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta la documentazione sui messaggi di errore.

Tipo di errore Dettagli errore Descrizione
forbidden (403) forbidden Non disponi delle autorizzazioni necessarie per modificare lo stato del messaggio specificato.
required (400) idRequired Il parametro obbligatorio id deve identificare il messaggio di cui vuoi modificare lo stato.
required (400) statusRequired La richiesta API deve specificare un valore per il parametro status.
notFound (404) liveChatMessagesNotFound Il messaggio specificato dal parametro id non esiste.
forbidden (403) modificationNotAllowed Non è possibile modificare lo stato della risorsa liveChatMessage specificata. Il parametro id potrebbe identificare un messaggio di cui non è possibile modificare lo stato.

Prova

Utilizza APIs Explorer per chiamare questa API e visualizzare la richiesta API e la risposta.