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 ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุผู้ใช้ CMS ของ YouTube ที่ทําหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหา 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
ระบุภาษาที่ผู้รายงานพูด

คำตอบ

หากสําเร็จ วิธีนี้จะแสดงผลโค้ดตอบกลับ 204 ของ HTTP (No Content)

ข้อผิดพลาด

ตารางด้านล่างระบุข้อความแสดงข้อผิดพลาดที่ API อาจส่งคืนกลับมาในการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) invalidAbuseReason คําขอมีค่าที่ไม่คาดคิดของพร็อพเพอร์ตี้ reasonId หรือชุดค่าผสมของพร็อพเพอร์ตี้ reasonId และ secondaryReasonId ไม่ถูกต้อง
badRequest (400) rateLimitExceeded ผู้ใช้ส่งคําขอมากเกินไปในกรอบเวลาที่กําหนด
forbidden (403) forbidden
notFound (404) videoNotFound ไม่พบวิดีโอที่คุณพยายามรายงานการละเมิด

ลองใช้เลย

ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคําขอและการตอบกลับ API