รายงานวิดีโอว่ามีเนื้อหาที่เป็นการละเมิด
ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีต้นทุนโควต้า 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ระบุภาษาที่ผู้รายงานข่าวพูด |
การตอบกลับ
หากสำเร็จ เมธอดนี้จะแสดงรหัสการตอบกลับ HTTP 204 (No Content)
ข้อผิดพลาด
ตารางด้านล่างระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงเมื่อมีการเรียกใช้เมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบเกี่ยวกับข้อความแสดงข้อผิดพลาด
| ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
|---|---|---|
badRequest (400) |
invalidAbuseReason |
คําขอมีค่าที่ไม่คาดคิดสําหรับพร็อพเพอร์ตี้ reasonId หรือชุดค่าผสมของพร็อพเพอร์ตี้ reasonId และ secondaryReasonId ที่ไม่ถูกต้อง |
badRequest (400) |
rateLimitExceeded |
ผู้ใช้ส่งคำขอมากเกินไปในกรอบเวลาที่กำหนด |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามรายงานการละเมิด |
ลองใช้งาน
ใช้ APIs Explorer เพื่อเรียก API นี้และดูคําขอและการตอบกลับของ API