檢舉含有不當內容的影片。
配額影響：呼叫此方法的配額費用為 50 個單位。
要求
HTTP 要求
POST https://www.googleapis.com/youtube/v3/videos/reportAbuse
授權
這項要求需要授權，且至少包含下列其中一個範圍 (進一步瞭解驗證和授權)。
| 範圍 |
|---|
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指定檢舉影片含有不當內容的次要原因。與 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 要求和回應。