สร้างความคิดเห็นระดับบนสุดใหม่ หากต้องการเพิ่มการตอบกลับความคิดเห็นที่มีอยู่ ให้ใช้เมธอด 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 ชื่อที่คุณสามารถใส่ในค่าพารามิเตอร์
|
เนื้อหาของคำขอ
ระบุทรัพยากร ThreadThread ในส่วนเนื้อหาของคําขอ สําหรับทรัพยากรดังกล่าว ให้ทําดังนี้
-
คุณต้องระบุค่าสําหรับพร็อพเพอร์ตี้เหล่านี้
snippet.channelId
snippet.topLevelComment.snippet.textOriginal
-
คุณตั้งค่าพร็อพเพอร์ตี้เหล่านี้ได้
snippet.channelId
snippet.videoId
snippet.topLevelComment.snippet.textOriginal
คำตอบ
หากสําเร็จ วิธีนี้ส่งคืนทรัพยากร ThreadThread ในเนื้อหาของการตอบกลับ
ข้อผิดพลาด
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด
ประเภทข้อผิดพลาด | รายละเอียดข้อผิดพลาด | คำอธิบาย |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
แต่ละชุดความคิดเห็นต้องลิงก์กับช่องหรือวิดีโอ
|
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