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