このページは Cloud Translation API によって翻訳されました。

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