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 プロパティで識別される主な理由よりも、不適切なコンテンツの詳細な説明を提供します。値を、適切な副次的な理由の 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 リクエストとレスポンスを表示します。