実装: 評価

次の例は、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 カンファレンスでの基調講演の動画に対する現在のユーザーの評価を取得します。（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 プロパティには値が含まれます。

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