Videos: rate
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
你可以為影片加上「喜歡」或「不喜歡」評分,或是移除影片的評分。
配額影響:呼叫這個方法的配額費用為 50 個單位。
注意:這項數據不會影響官方影片的喜歡/不喜歡人數。
常見用途
要求
HTTP 要求
POST https://www.googleapis.com/youtube/v3/videos/rate
授權
這項要求需要至少下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
內容範圍 |
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
參數
下表列出此查詢支援的參數。這裡列出的參數全都是查詢參數。
參數 |
必要參數 |
id |
string
id 參數會指定需要評分或移除影片的 YouTube 影片 ID。 |
rating |
string
指定要記錄的評分。
可接受的值如下:
dislike :記錄已驗證使用者不喜歡影片的記錄。
like :記錄已驗證使用者喜歡影片。
none - 移除驗證使用者先前為影片設定的任何分級。
|
回應
如果成功,這個方法會傳回 HTTP 204
回應代碼 (No Content
)。
錯誤
下表列出 API 回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息的說明文件。
錯誤類型 |
錯誤詳細資料 |
說明 |
badRequest (400) |
emailNotVerified |
評分之前,使用者必須驗證自己的電子郵件地址。 |
badRequest (400) |
invalidRating |
要求中 rating 參數含有非預期的值。 |
badRequest (400) |
videoPurchaseRequired |
只有已租借影片的使用者才能評分。 |
forbidden (403) |
forbidden |
無法評分您要評分的影片。要求可能未獲適當授權。 |
forbidden (403) |
videoRatingDisabled |
您要評分的影片擁有者已停用該影片的評分功能。 |
notFound (404) |
videoNotFound |
找不到您要評分的影片。檢查要求的 id 參數值,確認值正確無誤。 |
試試看!
使用 APIs Explorer 呼叫這個 API 並查看 API 要求和回應。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-04-26 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-04-26 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-04-26 (世界標準時間)。"]]