Comments: insert

สร้างการตอบกลับความคิดเห็นที่มีอยู่ หมายเหตุ: หากต้องการสร้างความคิดเห็นระดับบนสุด ให้ใช้เมธอด commentThreads.insert

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

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

ส่งคำขอ

คำขอ HTTP

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

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

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

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

พารามิเตอร์

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

พารามิเตอร์
พารามิเตอร์ที่จําเป็น
part string
พารามิเตอร์ part จะระบุพร็อพเพอร์ตี้ที่การตอบกลับ API จะรวมอยู่ด้วย กําหนดค่าพารามิเตอร์เป็น snippet ส่วน snippet มีค่าใช้จ่ายโควต้า 2 หน่วย

รายการต่อไปนี้มี part ชื่อที่คุณสามารถใส่ในค่าพารามิเตอร์
  • id
  • snippet

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

ระบุแหล่งข้อมูลความคิดเห็นในส่วนเนื้อหาของคําขอ สําหรับทรัพยากรดังกล่าว ให้ทําดังนี้

  • คุณต้องระบุค่าสําหรับพร็อพเพอร์ตี้เหล่านี้

    • snippet.textOriginal
    • snippet.parentId

  • คุณตั้งค่าพร็อพเพอร์ตี้เหล่านี้ได้

    • snippet.textOriginal

คำตอบ

หากทําสําเร็จ วิธีนี้จะแสดงผลทรัพยากรความคิดเห็นในส่วนเนื้อหาของการตอบกลับ

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) commentTextRequired ทรัพยากร comment ที่แทรกอยู่ต้องระบุค่าสําหรับพร็อพเพอร์ตี้ snippet.textOriginal ความคิดเห็นต้องไม่ว่างเปล่า
badRequest (400) commentTextTooLong ทรัพยากร comment ที่แทรกมีอักขระมากเกินไปในพร็อพเพอร์ตี้ snippet.textOriginal
badRequest (400) invalidCustomEmoji ทรัพยากร comment ที่แทรกมีอีโมจิที่กําหนดเองที่ไม่ถูกต้อง
badRequest (400) invalidCommentMetadata ข้อมูลเมตาของคําขอไม่ถูกต้อง
badRequest (400) operationNotSupported ผู้ใช้ API แทรกความคิดเห็นในการตอบกลับความคิดเห็นระดับบนสุดที่ระบุโดยพร็อพเพอร์ตี้ snippet.parentId ไม่ได้ ในทรัพยากร commentThread พร็อพเพอร์ตี้ snippet.canReply จะระบุว่าผู้ดูปัจจุบันตอบกลับชุดข้อความได้หรือไม่
badRequest (400) parentCommentIsPrivate ความคิดเห็นของผู้ปกครองที่ระบุเป็นแบบส่วนตัว API ไม่รองรับการตอบกลับความคิดเห็นส่วนตัว
badRequest (400) parentIdMissing ความคิดเห็นที่จะแทรกต้องลิงก์กับความคิดเห็นหลัก แต่ทรัพยากร comment ในเนื้อหาของคําขอ API ไม่ได้ระบุค่าสําหรับพร็อพเพอร์ตี้ snippet.parentId
badRequest (400) processingFailure เซิร์ฟเวอร์ API ดําเนินการตามคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดที่เกิดขึ้นชั่วคราว แต่มักจะระบุว่าอินพุตของคําขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากร comment ในส่วนเนื้อหาของคําขอเพื่อให้แน่ใจว่าถูกต้อง
forbidden (403) forbidden ไม่สามารถสร้างความคิดเห็นเนื่องจากสิทธิ์ไม่เพียงพอ คําขออาจไม่ได้รับอนุญาตอย่างถูกต้อง
forbidden (403) ineligibleAccount บัญชี YouTube ที่ใช้ให้สิทธิ์คําขอ API ต้องลิงก์กับบัญชี Google ของผู้ใช้เพื่อแทรกความคิดเห็นหรือชุดข้อความของความคิดเห็น
notFound (404) parentCommentNotFound ไม่พบความคิดเห็นระดับบนสุดที่ระบุ ตรวจสอบค่าของพร็อพเพอร์ตี้ snippet.parentId ในส่วนเนื้อหาของคําขอเพื่อให้แน่ใจว่าข้อมูลถูกต้อง

ลองใช้เลย

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