本頁面由 Cloud Translation API 翻譯而成。

LiveChatMessages: insert

在聊天室中新增訊息。這個 API 目前只能插入簡訊。

常見用途

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

此要求需要至少具備下列其中一個範圍的授權 (進一步瞭解驗證和授權)。

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

下表列出這項查詢支援的參數。上方列出的所有參數都是查詢參數。

參數
必要參數
`part`	`string` `part` 參數有兩個用途。可識別寫入作業將設定的屬性，以及 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 要求和回應。