建立新的頂層註解。如要新增回覆現有註解,請改用 comments.insert
方法。
配額影響:呼叫這個方法的配額費用為 50 個單位。
常見用途
要求
HTTP 要求
POST https://www.googleapis.com/youtube/v3/commentThreads
授權
這項要求需要至少下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
內容範圍 |
---|
https://www.googleapis.com/auth/youtube.force-ssl |
參數
下表列出此查詢支援的參數。這裡列出的參數全都是查詢參數。
參數 | ||
---|---|---|
必要參數 | ||
part |
string part 參數可識別 API 回應會包含的屬性。將參數值設為 snippet 。snippet 部分的配額費用為 2 個單位。下列清單包含可在參數值中加入的 part 名稱:
|
要求主體
在要求主體中提供 commentThread 資源。
您必須為該資源指定下列屬性的值:
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
回應
如果成功的話,這個方法會在回應內文中傳回 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 要求和回應。