Comments: insert

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

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

Use Case ทั่วไป

ส่งคำขอ

คำขอ 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