檢舉含有不當內容的影片。
配額影響:呼叫此方法的配額費用為 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 要求和回應。