Diese Seite wurde von der Cloud Translation API übersetzt.

LiveChatMessages: insert

Füge einem Livechat eine Nachricht oder Umfrage hinzu.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

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

Autorisierung

Diese Anfrage erfordert eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche. Weitere Informationen zu Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Authentifizierung implementieren.

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
`part`	`string` Der Parameter `part` dient zwei Zwecken. Sie gibt die Eigenschaften an, die durch den Schreibvorgang festgelegt werden, sowie die Eigenschaften, die in der API-Antwort enthalten sind. Legen Sie den Parameterwert auf `snippet` fest.

Anfragetext

Geben Sie im Anfragetext eine liveChatMessage-Ressource an. Für diese Ressource müssen Sie Werte für die folgenden Properties angeben.

snippet.liveChatId
snippet.type – Wählen Sie eine der folgenden Optionen aus: textMessageEvent oder pollEvent.
Wenn der Typ textMessageEvent ist, geben Sie snippet.textMessageDetails.messageText an.
Wenn „type“ pollEvent ist, geben Sie snippet.pollDetails mit den folgenden Werten an:
- snippet.pollDetails.metadata.options.questionText
- Liste von snippet.pollDetails.metadata.options.optionText. Sie müssen mindestens zwei und höchstens fünf Elemente angeben. Die Elemente werden in der Reihenfolge ihrer Auflistung angezeigt.

Antwort

Bei Erfolg gibt diese Methode eine liveChatMessage-Ressource im Antworttext zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen findest du unter YouTube Live Streaming API – Fehler.

Fehlertyp	Fehlerdetails	Beschreibung
`forbidden (403)`	`forbidden`	Sie haben nicht die erforderlichen Berechtigungen, um die angegebene Nachricht zu erstellen.
`forbidden (403)`	`liveChatDisabled`	Der angegebene Livechat wurde vom Inhaber deaktiviert. Das bedeutet, dass dem Chat keine Nachrichten hinzugefügt werden können.
`forbidden (403)`	`liveChatEnded`	Der angegebene Livechat ist nicht mehr aktiv.
`invalidValue (400)`	`messageTextInvalid`	Der Nachrichtentext (`snippet.textMessageDetails.messageText`) ist ungültig.
`notFound (404)`	`liveChatNotFound`	Der in der API-Anfrage angegebene Livechat ist nicht vorhanden. Dieser Fehler tritt auf, wenn der Chat vom Eigentümer gelöscht wurde.
`required (400)`	`liveChatIdRequired`	Die Ressource „liveChatMessage“ muss einen Wert für das Attribut `snippet.liveChatId` enthalten.
`required (400)`	`messageTextRequired`	Die Ressource „liveChatMessage“ muss einen Wert für das Attribut `snippet.textMessageDetails.messageText` enthalten.
`required (400)`	`typeRequired`	Die Ressource „liveChatMessage“ muss einen Wert für das Attribut `snippet.type` enthalten. Legen Sie den Parameterwert auf `text` fest.
`required (400)`	`preconditionCheckFailed`	Es gibt bereits eine angepinnte aktive Umfrage.
`rateLimitExceeded`	`rateLimitExceeded`	Der Nutzer hat in einem bestimmten Zeitraum zu viele Chatnachrichten gepostet.

Testen!

Verwenden Sie die APIs Explorer, um diese API aufzurufen und die API-Anfrage und ‑Antwort zu sehen.