CommentThreads: insert

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

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

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

ส่งคำขอ

คำขอ HTTP

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

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

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

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

พารามิเตอร์

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

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

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

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

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

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

    • snippet.channelId
    • snippet.topLevelComment.snippet.textOriginal

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

    • snippet.channelId
    • snippet.videoId
    • snippet.topLevelComment.snippet.textOriginal

คำตอบ

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

ข้อผิดพลาด

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

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

ลองใช้เลย

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