導入：評分

以下範例說明如何使用 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 大會主題演講影片的評分。(如果您在 API 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 屬性包含該值。

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