為影片加上喜歡或不喜歡的評分,或移除影片的評分。
配額影響:呼叫此方法的配額費用為 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 指定要錄製的評分。 可接受的值如下:
|
要求主體
呼叫這個方法時,請勿提供要求主體。
回應
如果成功,這個方法會傳回 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 要求和回應。