Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

Videos: rate

對影片表示喜歡或不喜歡，或移除對影片的評分。

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

注意：這不會影響影片的官方喜歡/不喜歡次數。

常見用途

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 要求和回應。