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 และการตอบกลับ