LiveChatMessages: insert

Einem Livechat wird eine Nachricht hinzugefügt. Die API unterstützt derzeit nur das Einfügen von SMS.

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

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

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
part string
Der Parameter part dient zwei Zwecken. Sie gibt die Attribute an, die der Schreibvorgang festlegt, sowie die Attribute, 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:

  • Für diese Eigenschaften müssen Sie einen Wert angeben:

    • snippet.liveChatId
    • snippet.type: Derzeit wird nur der Wert textMessageEvent unterstützt.
    • snippet.textMessageDetails.messageText

Antwort

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

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) forbidden Sie sind nicht berechtigt, die angegebene Nachricht zu erstellen.
forbidden (403) liveChatDisabled Der angegebene Livechat wurde vom Inhaber deaktiviert. Nachrichten können dem Chat also nicht hinzugefügt werden.
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 Inhaber gelöscht wurde.
rateLimitExceeded rateLimitExceeded Der Nutzer hat in einem bestimmten Zeitraum zu viele Chatnachrichten gepostet.
required (400) liveChatIdRequired Die liveChatMessage-Ressource muss einen Wert für das Attribut snippet.liveChatId enthalten und angeben.
required (400) messageTextRequired Die liveChatMessage-Ressource muss einen Wert für das Attribut snippet.textMessageDetails.messageText enthalten und angeben.
required (400) typeRequired Die liveChatMessage-Ressource muss einen Wert für das Attribut snippet.type enthalten und angeben. Parameterwert auf text festlegen

Testen!

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