Videos: rate

動画に高い/低い評価を追加したり、動画から評価を削除します。

割り当てへの影響: このメソッドを呼び出すと、50 ユニットの割り当てコストが発生します。

注: 動画の正式な高評価/低評価の数には影響しません。

一般的なユースケース

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/youtube/v3/videos/rate

承認

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。

範囲
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
id string
id パラメータは、評価の対象または評価を削除する動画の YouTube 動画 ID を指定します。
rating string
記録する評価を指定します。

有効な値は次のとおりです。
  • dislike – 認証されたユーザーが動画を低く評価したことを記録します。
  • like – 認証されたユーザーが動画を高く評価したことを記録します。
  • none – 認証されたユーザーが以前に動画に設定した評価を削除します。

リクエスト本文

このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。

レスポンス

成功すると、このメソッドは HTTP 204 レスポンス コード(No Content)を返します。

エラー

次の表に、このメソッドの呼び出しに応じて API から返されるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
badRequest (400) emailNotVerified ユーザーは評価前にメールアドレスを確認する必要があります。
badRequest (400) invalidRating リクエストの rating パラメータに予期しない値が含まれていました。
badRequest (400) videoPurchaseRequired レンタル動画を評価できるのは、その動画をレンタルしたユーザーのみです。
forbidden (403) forbidden 評価しようとしている動画は評価できません。リクエストが適切に認証されない可能性があります。
forbidden (403) videoRatingDisabled 評価しようとしている動画の所有者がその動画の評価を無効にしています。
notFound (404) videoNotFound 評価しようとしている動画は見つかりません。リクエストの id パラメータの値が正しいことを確認してください。

試してみよう:

APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。