Comments: setModerationStatus

ตั้งค่าสถานะการดูแลความคิดเห็นอย่างน้อย 1 รายการ คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็น

ผลกระทบของโควต้า: การเรียกใช้วิธีนี้มีค่าใช้จ่ายโควต้า 50 หน่วย

Use Case ทั่วไป

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/youtube/v3/comments/setModerationStatus

การให้สิทธิ์

คำขอนี้ต้องได้รับสิทธิ์อย่างน้อย 1 ขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtube.force-ssl

พารามิเตอร์

ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงอยู่เป็นพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
id string
พารามิเตอร์ id จะระบุรายการรหัสที่คั่นด้วยคอมมา ซึ่งระบุความคิดเห็นที่คุณจะอัปเดตสถานะการกลั่นกรอง
moderationStatus string
ระบุสถานะการกลั่นกรองใหม่ของความคิดเห็นที่ระบุ

ค่าที่ยอมรับ ได้แก่
  • heldForReview – ทำเครื่องหมายความคิดเห็นว่ารอการตรวจสอบโดยผู้ดูแล
  • published – ล้างความคิดเห็นที่จะแสดงต่อสาธารณะ
  • rejected – ปฏิเสธความคิดเห็นว่าไม่เหมาะที่จะแสดง การดำเนินการนี้จะซ่อนการตอบกลับทั้งหมดสำหรับความคิดเห็นที่ถูกปฏิเสธได้อย่างมีประสิทธิภาพ
พารามิเตอร์ที่ไม่บังคับ
banAuthor boolean
พารามิเตอร์ banAuthor ช่วยให้คุณระบุว่าต้องการปฏิเสธความคิดเห็นอื่นๆ ที่ผู้เขียนความคิดเห็นเขียนโดยอัตโนมัติ ตั้งค่าพารามิเตอร์เป็น true เพื่อแบนผู้เขียน

หมายเหตุ: พารามิเตอร์นี้จะใช้ได้เฉพาะเมื่อตั้งค่าพารามิเตอร์ moderationStatus เป็น rejected ด้วย

เนื้อหาของคำขอ

ไม่ต้องระบุเนื้อหาคำขอเมื่อเรียกใช้เมธอดนี้

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงรหัสการตอบกลับ HTTP 204 (No Content)

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) banWithoutReject สามารถใช้พารามิเตอร์ banAuthor ได้ก็ต่อเมื่อค่าพารามิเตอร์ moderationStatus เป็น rejected
badRequest (400) operationNotSupported การแสดงความคิดเห็นที่ไม่ได้อิงจาก Google+ จะมีฟังก์ชันการกลั่นกรองแบบจำกัดเท่านั้น
badRequest (400) processingFailure เซิร์ฟเวอร์ API ประมวลผลคำขอไม่สำเร็จ ข้อผิดพลาดนี้อาจเป็นข้อผิดพลาดชั่วคราว แต่โดยทั่วไปจะระบุว่าอินพุตของคำขอไม่ถูกต้อง
forbidden (403) forbidden ไม่สามารถตั้งค่าสถานะการกลั่นกรองของความคิดเห็นอย่างน้อย 1 รายการได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง
notFound (404) commentNotFound ไม่พบความคิดเห็นที่คำขอพยายามอัปเดตอย่างน้อย 1 รายการ ตรวจสอบค่าพารามิเตอร์ id ของคําขอเพื่อให้แน่ใจว่าถูกต้อง

ลองใช้เลย

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