Fügt einem Livechat eine Nachricht hinzu.
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).
Bereich |
---|
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 identifiziert die Eigenschaften, die durch den Schreibvorgang festgelegt werden, sowie die Eigenschaften, die die API-Antwort enthalten wird. 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 diese Attribute angeben
snippet.liveChatId
snippet.type
–textMessageEvent
verwendensnippet.textMessageDetails.messageText
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine liveChatMessage-Ressource im Antworttext zurückgegeben.
Fehler
In der folgenden Tabelle finden Sie Fehlermeldungen, 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 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 beendet. |
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 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 |
required (400) |
preconditionCheckFailed |
Eine angepinnte aktive Umfrage ist bereits vorhanden. |
rateLimitExceeded |
rateLimitExceeded |
Der Nutzer hat in einem bestimmten Zeitraum zu viele Chatnachrichten gepostet. |
Jetzt testen
Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.