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

Comments: insert

回覆現有註解。注意：如要建立頂層註解，請使用 commentThreads.insert 方法。

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

常見用途

要求

HTTP 要求

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

授權

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

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

參數

下表列出此查詢支援的參數。這裡列出的參數全都是查詢參數。

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

要求主體

在要求主體中提供註解資源。針對該資源：

您必須指定下列屬性的值：
- snippet.textOriginal
- snippet.parentId
您可以設定下列屬性的值：
- snippet.textOriginal

回應

如果成功的話，這個方法會在回應內文中傳回註解資源。

錯誤

下表列出 API 回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息的說明文件。

錯誤類型	錯誤詳細資料	說明
`badRequest (400)`	`commentTextRequired`	要插入的 `comment` 資源必須指定 `snippet.textOriginal` 屬性的值。註解不得留空。
`badRequest (400)`	`commentTextTooLong`	目前插入的 `comment` 資源的 `snippet.textOriginal` 屬性含有過多字元。
`badRequest (400)`	`invalidCustomEmoji`	目前插入的 `comment` 資源含有無效的自訂表情符號。
`badRequest (400)`	`invalidCommentMetadata`	要求的中繼資料無效。
`badRequest (400)`	`operationNotSupported`	API 使用者無法在 `snippet.parentId` 屬性識別的頂層註解中插入註解。在 `commentThread` 資源中，`snippet.canReply` 屬性會指出目前的檢視者是否能回覆討論串。
`badRequest (400)`	`parentCommentIsPrivate`	指定的父項留言是私人留言。API 不支援回覆私人留言。
`badRequest (400)`	`parentIdMissing`	目前插入的註解必須連結至母註解。然而，API 要求主體中的 `comment` 資源並未指定 `snippet.parentId` 屬性的值。
`badRequest (400)`	`processingFailure`	API 伺服器無法成功處理要求。雖然這可能是暫時性錯誤，但通常表示要求的輸入內容無效。檢查要求主體中的 `comment` 資源結構，確保資源有效。
`forbidden (403)`	`forbidden`	權限不足，因此無法建立註解。要求可能未獲適當授權。
`forbidden (403)`	`ineligibleAccount`	用來授權 API 要求的 YouTube 帳戶必須與使用者的 Google 帳戶合併，才能插入留言或留言串。
`notFound (404)`	`parentCommentNotFound`	找不到指定的父項註解。檢查要求主體中的 `snippet.parentId` 屬性值，確保其正確。

試試看！

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