回覆現有留言。注意:如要建立頂層註解,請使用 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 名稱,您可以將其納入參數值中:
|
要求主體
在要求主體中提供註解資源。這項資源:
-
您必須指定這些屬性的值:
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 要求和回應。