我們正在更新 Data API,以符合 YouTube 計算 Shorts 觀看次數的方式。
瞭解詳情
VideoAbuseReportReasons
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
videoAbuseReportReason
資源包含影片遭標記為含有不當內容的原因。當應用程式呼叫 videos.reportAbuse
方法來檢舉不當影片時,要求會使用 videoAbuseReportReason
資源中的資訊,找出檢舉影片的原因。
方法
這個 API 支援 videoAbuseReportReasons
資源的下列方法:
- list
- 擷取可用於檢舉不當影片的原因清單。立即試用。
屬性
下表定義了這個資源中顯示的屬性:
屬性 |
kind |
string
識別 API 資源的類型。值為 youtube#videoAbuseReportReason 。 |
etag |
etag
這項資源的 Etag。 |
id |
string
YouTube 用來識別原因的 ID。呼叫 videos.reportAbuse 方法時,應用程式應使用這個值來設定 reasonId 屬性。 |
snippet |
object
snippet 物件包含原因的基本詳細資料。 |
snippet.label |
string
濫用檢舉原因的本地化標籤文字。 |
snippet.secondaryReasons[] |
list
與原因相關的次要原因清單 (如有)。(可能為 0 或更多)。 |
snippet.secondaryReasons[].id |
string
YouTube 用來識別次要原因的 ID。呼叫 videos.reportAbuse 方法時,應用程式應使用這個值來設定 secondaryReasonId 屬性。 |
snippet.secondaryReasons[].label |
string
次要原因的本地化標籤文字。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-21 (世界標準時間)。
[null,null,["上次更新時間:2025-08-21 (世界標準時間)。"],[[["\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,["# VideoAbuseReportReasons\n\nA **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-------\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-----------------------\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\n### Properties\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. |"]]