實作：評分

以下範例說明如何使用 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 資源不同，因此您可以選擇最符合需求的方法。