We are updating the Data API to match how YouTube counts views for Shorts.
Learn more
VideoAbuseReportReasons
Stay organized with collections
Save and categorize content based on your preferences.
A videoAbuseReportReason
resource contains information about a reason that a video would be flagged for containing abusive content. When your application calls the videos.reportAbuse
method to report an abusive video, the request uses the information from a videoAbuseReportReason
resource to identify the reason that the video is being reported.
Methods
The API supports the following methods for videoAbuseReportReasons
resources:
- list
- Retrieve a list of reasons that can be used to report abusive videos.
Try it now.
Resource representation
The following JSON structure shows the format of a videoAbuseReportReason
resource:
{
"kind": "youtube#videoAbuseReportReason",
"etag": etag,
"id": string,
"snippet": {
"label": string,
"secondaryReasons": [
{
"id": string,
"label": string
}
]
}
}
Properties
The following table defines the properties that appear in this resource:
Properties |
kind |
string
Identifies the API resource's type. The value will be youtube#videoAbuseReportReason . |
etag |
etag
The Etag of this resource. |
id |
string
The ID that YouTube uses to identify the reason. When calling the videos.reportAbuse method, your application should use this value to set the reasonId property. |
snippet |
object
The snippet object contains basic details about the reason. |
snippet.label |
string
The localized label text for the abuse report reason. |
snippet.secondaryReasons[] |
list
A list of secondary reasons associated with the reason, if any are available. (There might be 0 or more.) |
snippet.secondaryReasons[].id |
string
The ID that YouTube uses to identify the secondary reason. When calling the videos.reportAbuse method, your application should use this value to set the secondaryReasonId property. |
snippet.secondaryReasons[].label |
string
The localized label text for the secondary reason. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eA \u003ccode\u003evideoAbuseReportReason\u003c/code\u003e resource provides the reasons for flagging a video as abusive.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003evideos.reportAbuse\u003c/code\u003e method utilizes \u003ccode\u003evideoAbuseReportReason\u003c/code\u003e data to specify why a video is being reported.\u003c/p\u003e\n"],["\u003cp\u003eThe API's \u003ccode\u003evideoAbuseReportReasons.list\u003c/code\u003e method lets users get a list of reasons for reporting abusive videos.\u003c/p\u003e\n"],["\u003cp\u003eThe resource is represented in JSON format, containing an id, kind, etag and snippet, along with additional nested information, such as secondary reasons.\u003c/p\u003e\n"],["\u003cp\u003eEach of the labels and secondary reasons available to report a video with also have an ID that is used when using the \u003ccode\u003evideos.reportAbuse\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The `videoAbuseReportReason` resource provides data for flagging abusive video content. It contains an ID, localized label, and optional secondary reasons, each with their ID and label. The `videos.reportAbuse` method uses the `videoAbuseReportReason` data, which you can list by calling the `videoAbuseReportReasons/list` method. The resource's `id` property is used in the `videos.reportAbuse` method to define the reason for the report. Secondary reasons are listed in the `snippet` property.\n"],null,["A **videoAbuseReportReason** resource contains information about a reason that a video would be flagged for containing abusive content. When your application calls the [videos.reportAbuse](/youtube/v3/docs/videos/reportAbuse) method to report an abusive video, the request uses the information from a `videoAbuseReportReason` resource to identify the reason that the video is being reported.\n\nMethods\n\nThe API supports the following methods for `videoAbuseReportReasons` resources:\n\n[list](/youtube/v3/docs/videoAbuseReportReasons/list)\n: Retrieve a list of reasons that can be used to report abusive videos.\n [Try it now](/youtube/v3/docs/videoAbuseReportReasons/list#usage).\n\nResource representation\n\nThe following JSON structure shows the format of a `videoAbuseReportReason` resource: \n\n```text\n{\n \"kind\": \"youtube#videoAbuseReportReason\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"label\": string,\n \"secondaryReasons\": [\n {\n \"id\": string,\n \"label\": string\n }\n ]\n }\n}\n```\n\nProperties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#videoAbuseReportReason`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to identify the reason. When calling the `videos.reportAbuse` method, your application should use this value to set the [reasonId](/youtube/v3/docs/videos/reportAbuse#reasonId) property. |\n| `snippet` | `object` The `snippet` object contains basic details about the reason. |\n| snippet.`label` | `string` The localized label text for the abuse report reason. |\n| snippet.`secondaryReasons[]` | `list` A list of secondary reasons associated with the reason, if any are available. (There might be 0 or more.) |\n| snippet.secondaryReasons[].`id` | `string` The ID that YouTube uses to identify the secondary reason. When calling the `videos.reportAbuse` method, your application should use this value to set the [secondaryReasonId](/youtube/v3/docs/videos/reportAbuse#secondaryReasonId) property. |\n| snippet.secondaryReasons[].`label` | `string` The localized label text for the secondary reason. |"]]