Comments: setModerationStatus

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

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

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ HTTP

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

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

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

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

พารามิเตอร์

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

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

ค่าที่ยอมรับมีดังนี้
  • heldForReview \- ทำเครื่องหมายความคิดเห็นว่ารอการตรวจสอบโดยผู้ดูแล
  • published \- ล้างความคิดเห็นเพื่อแสดงต่อสาธารณะ คุณไม่สามารถเปลี่ยนสถานะการดูแลของความคิดเห็นที่ถูกปฏิเสธเป็น published ได้
  • rejected \- ปฏิเสธความคิดเห็นว่าไม่เหมาะที่จะแสดง การดำเนินการนี้จะซ่อนการตอบกลับทั้งหมดของความคิดเห็นที่ถูกปฏิเสธด้วย หากต้องการนำความคิดเห็นที่เขียนโดยผู้ใช้รายอื่นออกจากช่องหรือวิดีโอ ให้ตั้งค่าสถานะการดูแลเป็น rejected เมธอด comments.delete ใช้ได้โดยผู้เขียนความคิดเห็นเดิมเท่านั้น
พารามิเตอร์ที่ไม่บังคับ
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