このページは Cloud Translation API によって翻訳されました。

LiveChatMessages: insert

チャットにメッセージを追加します。現在、この API ではテキストメッセージのみを挿入できます。

一般的なユースケース

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

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です（認証と承認の詳細をご確認ください）。

範囲
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリパラメータです。

パラメータ
必須パラメータ
`part`	`string` `part` パラメータは 2 つの目的で使用されます。書き込みオペレーションで設定するプロパティと、API レスポンスに含まれるプロパティを指定します。パラメータ値を `snippet` に設定します。

リクエストの本文に liveChatMessage リソースを指定します。対象リソース:

以下のプロパティの値を指定する必要があります。
- snippet.liveChatId
- snippet.type: 現在サポートされている値は textMessageEvent のみです。
- snippet.textMessageDetails.messageText

成功すると、このメソッドはレスポンスの本文で liveChatMessage リソースを返します。

次の表に、このメソッドの呼び出しに応じて API から返される可能性のあるエラーメッセージを示します。詳細については、エラーメッセージのドキュメントを参照してください。

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`forbidden`	指定したメッセージを作成するために必要な権限がありません。
`forbidden (403)`	`liveChatDisabled`	指定されたチャットはオーナーが無効にしているため、チャットに追加することはできません。
`forbidden (403)`	`liveChatEnded`	指定されたチャットはライブではなくなりました。
`invalidValue (400)`	`messageTextInvalid`	メッセージテキスト（`snippet.textMessageDetails.messageText`）が無効です。
`notFound (404)`	`liveChatNotFound`	API リクエストで特定されたチャットが存在しません。このエラーは、オーナーによってチャットが削除された場合に発生します。
`rateLimitExceeded`	`rateLimitExceeded`	ユーザーが一定期間に投稿したチャットメッセージが多すぎる。
`required (400)`	`liveChatIdRequired`	liveChatMessage リソースには、`snippet.liveChatId` プロパティの値を設定し、指定する必要があります。
`required (400)`	`messageTextRequired`	liveChatMessage リソースには、`snippet.textMessageDetails.messageText` プロパティの値を設定し、指定する必要があります。
`required (400)`	`typeRequired`	liveChatMessage リソースには、`snippet.type` プロパティの値を設定し、指定する必要があります。パラメータ値を `text` に設定します。

APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。