次の例は、YouTube Data API(v3)を使用して動画の評価に関連する機能を実行する方法を示しています。
動画の評価
動画に対するユーザーの評価を送信するには、videos.rate
メソッドを呼び出します。このリクエストは、OAuth 2.0 を使用して承認する必要があります。
リクエストに次の 2 つのパラメータを設定します。
id
パラメータでは、評価する(または評価を削除する)YouTube 動画の ID を指定します。rating
パラメータでは、リクエストを承認したユーザーによる評価を指定します。有効なパラメータ値はlike
、dislike
、none
です。最初の 2 つの値は評価を設定し、3 つ目の値はユーザーの以前の評価を削除します。
以下のサンプル リクエストでは、2014 年の Google I/O カンファレンスで基調講演の動画に高評価(高評価)を付けています。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate? id=wtLJPvx7-ys &rating=like
動画に対する現在のユーザーの評価を取得する
videos.getRating
メソッドを使用すると、現在認証されている 1 つ以上の動画のユーザーの評価を取得できます。リクエストで、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
contentDetails.relatedPlaylists.likes
プロパティには値が含まれます。この API を使用すると、
videos.list
メソッドまたは playlistItems.list
メソッドを使用して、ユーザーが気に入った動画のリストを取得できます。video
リソースでは playlistItem
リソースとは異なる情報が返されるため、ニーズに最適な方法を選択できます。