Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

CommentThreads: insert

建立新的頂層留言。如要回覆現有留言，請改用 comments.insert 方法。

配額影響：呼叫這個方法會產生 50 個單位的配額費用。

常見用途

POST https://www.googleapis.com/youtube/v3/commentThreads

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

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

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

參數
必要參數
`part`	`string` `part` 參數會識別 API 回應包含的屬性。將參數值設為 `snippet`。`snippet` 部分的配額費用為 2 個單位。下列清單包含可納入參數值的 `part` 名稱： `id` `replies` `snippet`

在要求主體中提供 commentThread 資源。

您必須為該資源的下列屬性指定值：

如果成功，這個方法會在回應主體中傳回 commentThread 資源。

下表列出 API 可能在呼叫這個方法時傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。

錯誤類型	錯誤詳細資料	說明
`badRequest (400)`	`channelOrVideoIdMissing`	每個留言討論串都必須連結至影片。請確認資源已指定 `snippet.channelId` 和 `snippet.videoId` 屬性的值。影片留言會顯示在影片觀賞頁面。
`badRequest (400)`	`commentTextRequired`	插入的 `comment` 資源必須指定 `snippet.topLevelComment.snippet.textOriginal` 屬性的值。留言內容不得為空。
`badRequest (400)`	`commentTextTooLong`	要插入的 `comment` 資源的 `snippet.topLevelComment.snippet.textOriginal` 屬性包含過多字元。
`badRequest (400)`	`invalidCommentThreadMetadata`	要求中繼資料無效。
`badRequest (400)`	`processingFailure`	API 伺服器無法順利處理要求，雖然這可能是暫時性錯誤，但通常表示要求的輸入內容無效。檢查要求主體中的 `commentThread` 資源結構，確認結構有效。
`forbidden (403)`	`forbidden`	權限不足，無法建立註解討論串。要求可能未獲得適當授權。
`forbidden (403)`	`ineligibleAccount`	如要插入留言或留言串，用來授權 API 要求的 YouTube 帳戶必須與使用者的 Google 帳戶合併。
`notFound (404)`	`channelNotFound`	找不到指定的頻道。請檢查 `snippet.channelId` 屬性的值，確保正確無誤。
`notFound (404)`	`videoNotFound`	找不到指定的影片。檢查 `snippet.videoId` 屬性的值，確認是否正確。

使用 APIs Explorer 呼叫這個 API，並查看 API 要求和回應。