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

เนื้อความของคำขอ

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