不適切な動画を報告するために使用できる理由の一覧を取得する。
割り当てへの影響: このメソッドの呼び出しには、1 ユニットの割り当てコストが発生します。
一般的なユースケース
リクエスト
HTTP リクエスト
GET https://www.googleapis.com/youtube/v3/videoAbuseReportReasons
認可
このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。
範囲 |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
https://www.googleapis.com/auth/youtube.readonly |
パラメータ
次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
パラメータ | ||
---|---|---|
必須パラメータ | ||
part |
string part パラメータには、API レスポンスに含める videoAbuseReportReason リソース パーツを指定します。サポートされている値は id と snippet です。 |
|
オプション パラメータ | ||
hl |
string hl パラメータは、API レスポンスのテキスト値に使用する言語を指定します。デフォルト値は en_US です。 |
リクエスト本文
このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{ "kind": "youtube#videoAbuseReportReasonListResponse", "etag": etag, "items": [ videoAbuseReportReason resource ] }
プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
プロパティ | |
---|---|
kind |
string API リソースのタイプを識別します。値は youtube#videoAbuseReportReasonListResponse です。 |
etag |
etag このリソースの Etag。 |
items[] |
list videoAbuseReportReason リソースのリスト。各リソースには、不適切なコンテンツが含まれていると報告される可能性のある理由が指定されます。videos.reportAbuse メソッドを呼び出すときにこの情報を使用して、不適切なコンテンツを含む動画を実際に報告します。 |
エラー
次の表に、このメソッドの呼び出しに対して API から返されるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。
エラーのタイプ | エラーの詳細 | 説明 |
---|---|---|
forbidden (403) |
forbidden |
試してみよう:
APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。