LiveChatMessages: transition

Ändert den Status einer YouTube-Livechatnachricht und initiiert alle Prozesse im Zusammenhang mit dem neuen Status. Wenn Sie beispielsweise den Status einer Live-Umfrage zu closed ändern, beendet YouTube die Umfrage dieser Nachricht. Bevor du diese Methode aufrufst, solltest du prüfen, ob der Wert des Attributs status für die Live-Umfragenachricht active ist.

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/liveChatMessages/transition

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

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

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
id string
Der Parameter id gibt die eindeutige ID der Nachricht an, die in einen anderen Status wechselt.
status enum
Der Parameter status gibt den Status an, in den die Nachricht geändert wird. Um eine Nachricht in den Status closed zu versetzen, muss status für die Abfrage, an die die Nachricht gebunden ist, active sein.

Sie können nur zu closed wechseln. Die Umfrage ist damit beendet.
Optionale Parameter
part string
Der Parameter part gibt die liveChatMessage-Ressourcenteile an, die in der API-Antwort enthalten sein sollen. Unterstützte Werte sind id, snippet und authorDetails.

Legen Sie den Parameterwert auf snippet fest, um das endgültige Umfrageergebnis im Antworttext zu erhalten.

Anfragetext

Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine liveChatMessages-Ressource im Antworttext zurückgegeben.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Sie haben nicht die erforderlichen Berechtigungen, um den Status der angegebenen Nachricht zu ändern.
required (400) idRequired Der erforderliche id-Parameter muss die Nachricht identifizieren, deren Status Sie umstellen möchten.
required (400) statusRequired In der API-Anfrage muss ein Wert für den Parameter status angegeben werden.
notFound (404) liveChatMessagesNotFound Die durch den Parameter id angegebene Nachricht ist nicht vorhanden.
forbidden (403) modificationNotAllowed Der Status der angegebenen liveChatMessage-Ressource kann nicht umgestellt werden. Der Parameter id gibt möglicherweise eine Mitteilung an, deren Status nicht umgestellt werden kann.

Testen!

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.