Videos: reportAbuse

รายงานวิดีโอเนื่องจากมีเนื้อหาที่เป็นการละเมิด

ผลกระทบของโควต้า: การเรียกใช้วิธีการนี้มีค่าใช้จ่ายโควต้า 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