導入：評分

下列範例說明如何使用 YouTube Data API (v3) 執行影片評分相關功能。

對影片評分

呼叫 videos.rate 方法即可提交使用者影片的評分。這個請求必須使用 OAuth 2.0 授權。

在要求中設定以下兩個參數：

• id 參數會指定正在評分 (或已移除分級) 影片的 YouTube 影片 ID。
• rating 參數會指定使用者授權要求所記錄的評分。有效的參數值為 like、dislike 和 none。前兩個值設定評分，第三個值則移除使用者先前存在的所有評分。

下方的要求範例會針對 2014 年 Google I/O 大會的主題演講影片給予正評價 (例如)：

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

擷取目前使用者對影片的評分

videos.getRating 方法可讓您擷取目前已驗證使用者的一或多部影片評分。在您的要求中，將 id 參數值設為以半形逗號分隔的清單，針對您要擷取評分資料的資源列出 YouTube 影片 ID。請注意，這個請求必須使用 OAuth 2.0 授權。

下方的要求範例會擷取目前使用者對 2014 年 Google I/O 大會上主題演講影片的評分。(如果您在 APIs Explorer 中執行上述範例，API 回應應會指出評分為 like。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

擷取目前使用者給予的影片評分

videos.list 方法的 myRating 參數可讓您擷取經使用者授權 API 要求評分的影片清單。參數值可指明您要擷取「喜歡」或「不喜歡」的影片。

以下要求範例會擷取目前使用者給予 like 評分的影片清單。請求必須使用 OAuth 2.0 授權。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like

注意：您也可以按照擷取頻道中收藏的影片的程序，擷取使用者喜歡的影片清單 (但不包含不喜歡的影片)。在這項程序的步驟 1 中，請擷取頻道喜歡影片的播放清單 ID，而不是擷取頻道最愛影片的播放清單 ID。contentDetails.relatedPlaylists.likes 屬性包含值。

因此，這個 API 可讓您使用 videos.list 方法或 playlistItems.list 方法，擷取使用者喜歡的影片清單。由於 video 資源與 playlistItem 資源傳回的資訊不同，因此您可以選擇最符合需求的方法。