LiveChatMessages: insert
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.liveChatIdsnippet.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.
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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-01-02 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-01-02 (UTC)."],[],[],null,["# LiveChatMessages: insert\n\nAdds a message or a poll to a live chat.\n\nCommon use cases\n----------------\n\nThe list below shows common use cases for this method. Hover over a use case to see its description, or click on a use case to load sample parameter values in the APIs Explorer. You can open the [fullscreen APIs Explorer](#) to see code samples that dynamically update to reflect the parameter values entered in the Explorer.\n\nThe table below shows common use cases for this method. You can click on a use case name to load sample parameter values in the APIs Explorer. Or you can see code samples for a use case in the fullscreen APIs Explorer by clicking on the code icon below a use case name. In the fullscreen UI, you can update parameter and property values and the code samples will dynamically update to reflect the values you enter. \nThis method has one common use case, which is described below. The buttons below the description populate the APIs Explorer with sample values or open the fullscreen APIs Explorer to show code samples that use those values. The code samples also dynamically update if you change the values.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/youtube/v3/liveChat/messages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 authentication](/youtube/v3/live/authentication).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter serves two purposes. It identifies the properties that the write operation will set as well as the properties that the API response will include. Set the parameter value to `snippet`. |\n\n### Request body\n\nProvide a [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) in the request body.\nFor that resource, you must specify values for these properties\n\n- `snippet.liveChatId`\n- `snippet.type` - choose one of the following options: `textMessageEvent` or `pollEvent`\n- If type is `textMessageEvent`, include `snippet.textMessageDetails.messageText`\n- If type is `pollEvent`, include `snippet.pollDetails` with the following values:\n - `snippet.pollDetails.metadata.options.questionText`\n - List of `snippet.pollDetails.metadata.options.optionText`. You must list at least two items and no more than four items. Items are displayed sequentially in the order they're listed.\n\nResponse\n--------\n\nIf successful, this method returns a [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) in the response body.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Live Streaming API - Errors](/youtube/v3/live/docs/errors).\n\n| Error type | Error detail | Description |\n|----------------------|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `forbidden (403)` | `forbidden` | You don't have the permissions required to create the specified message. |\n| `forbidden (403)` | `liveChatDisabled` | The specified live chat has been disabled by the owner, which means messages cannot be added to the chat. |\n| `forbidden (403)` | `liveChatEnded` | The specified live chat is no longer live. |\n| `invalidValue (400)` | `messageTextInvalid` | The message text (`snippet.textMessageDetails.messageText`) is not valid. |\n| `notFound (404)` | `liveChatNotFound` | The live chat identified in the API request does not exist. This error occurs if the chat has been deleted by the owner. |\n| `required (400)` | `liveChatIdRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.liveChatId` property. |\n| `required (400)` | `messageTextRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.textMessageDetails.messageText` property. |\n| `required (400)` | `typeRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.type` property. Set the parameter value to `text` |\n| `required (400)` | `preconditionCheckFailed` | A pinned active poll already exists. |\n| `rateLimitExceeded` | `rateLimitExceeded` | The user has posted too many chat messages in a given timeframe. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
