Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Videos: rate

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

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

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

一般的なユースケース

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 リクエストとレスポンスを確認します。