CommentThreads: insert

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

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

Use Case ทั่วไป

ส่งคำขอ

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

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

ระบุทรัพยากรcommentThreadในเนื้อหาคำขอ

สำหรับทรัพยากรนั้น คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้ต่อไปนี้

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

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงทรัพยากรcommentThreadในเนื้อหาการตอบกลับ

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) channelOrVideoIdMissing ชุดข้อความของความคิดเห็นแต่ละชุดต้องลิงก์กับวิดีโอ ตรวจสอบว่าทรัพยากรระบุค่าสำหรับพร็อพเพอร์ตี้ 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