รายงานวิดีโอเนื่องจากมีเนื้อหาที่เป็นการละเมิด
ผลกระทบของโควต้า: การเรียกใช้วิธีการนี้มีค่าใช้จ่ายโควต้า 50 หน่วย
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/youtube/v3/videos/reportAbuse
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์อย่างน้อย 1 ขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
---|
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 ของวิดีโอนั้น |
reasonId |
object ระบุเหตุผลที่วิดีโอที่มีเนื้อหาที่เป็นการละเมิด ตั้งค่าเป็น unique ID ของทรัพยากร videoAbuseReportReason ที่เหมาะสม |
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