実装: 評価

次の例は、YouTube Data API(v3)を使用して動画の評価に関連する機能を実行する方法を示しています。

動画の評価

動画に対するユーザーの評価を送信するには、videos.rate メソッドを呼び出します。このリクエストは、OAuth 2.0 を使用して承認する必要があります。

リクエストに次の 2 つのパラメータを設定します。

  • id パラメータでは、評価する(または評価を削除する)YouTube 動画の ID を指定します。
  • rating パラメータでは、リクエストを承認したユーザーによる評価を指定します。有効なパラメータ値は likedislikenone です。最初の 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
注: チャンネルのお気に入りの動画を取得する手順に沿って、ユーザーの高評価(ただし低評価)の動画のリストを取得することもできます。このプロセスのステップ 1 で、チャンネルのお気に入りの動画の再生リスト ID を取得する代わりに、チャンネルで高く評価した動画の再生リスト ID を取得します。contentDetails.relatedPlaylists.likes プロパティには値が含まれます。

この API を使用すると、videos.list メソッドまたは playlistItems.list メソッドを使用して、ユーザーが気に入った動画のリストを取得できます。video リソースでは playlistItem リソースとは異なる情報が返されるため、ニーズに最適な方法を選択できます。