Videos: reportAbuse

不適切なコンテンツを含む動画を報告します。

割り当ての影響: このメソッドを呼び出すと、割り当てコストは 50 単位になります。

リクエスト

HTTP リクエスト

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

承認

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

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

パラメータ

下記の表は、このクエリでサポートされているパラメータの一覧です。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
オプション パラメータ
onBehalfOfContentOwner string
このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは、YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwner パラメータは、パラメータ値で指定されたコンテンツ所有者に代わって行動する YouTube CMS ユーザーを識別するリクエストの認証情報です。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネル データにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。

リクエスト本文

リクエストの本文のデータ構造は次のとおりです。

{
  "videoId": string,
  "reasonId": string,
  "secondaryReasonId": string,
  "comments": string,
  "language": string
}

必須プロパティ

次のプロパティの値を設定する必要があります。

省略可能なプロパティ

次のプロパティの値を設定できます。

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。

プロパティ
videoId string
不適切なコンテンツを含むために報告されている動画を示します。値をその動画の YouTube 動画 ID に設定します。
reasonId object
不適切なコンテンツが含まれている動画を報告する理由を指定します。値を適切な videoAbuseReportReason リソースの unique ID に設定します。
secondaryReasonId object
不適切なコンテンツを含む動画について報告される 2 つ目の理由を指定します。第 2 の理由は、reasonId プロパティが特定する主要な理由よりも、不適切なコンテンツに関するより具体的な説明です。値を適切な第 2 の理由（unique ID）に設定します。
comments string
報告者が追加を希望する情報があれば指定します。
language object
報告者が話す言語を識別します。

レスポンス

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

エラー

次の表は、このメソッドを呼び出したときに API からレスポンスとして返される可能性のあるエラー メッセージの一覧です。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
badRequest (400) invalidAbuseReason リクエストに reasonId プロパティの予期しない値、または reasonId と secondaryReasonId プロパティの無効な組み合わせが含まれていました。
badRequest (400) rateLimitExceeded 特定の期間内にユーザーが送信したリクエストが多すぎます。
forbidden (403) forbidden
notFound (404) videoNotFound 不正行為を報告しようとしている動画が見つかりません。

実習

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