ทรัพยากร commentThread
มีข้อมูลเกี่ยวกับชุดความคิดเห็นของ YouTube ซึ่งประกอบด้วยความคิดเห็นและการตอบกลับระดับบนสุด หากมี ทรัพยากร commentThread
แสดงถึงความคิดเห็นเกี่ยวกับวิดีโอหรือช่องได้
ทั้งความคิดเห็นระดับบนสุดและการตอบกลับคือทรัพยากร comment
ที่ฝังอยู่ภายในทรัพยากร commentThread
ทรัพยากร commentThread
ไม่จําเป็นต้องตอบกลับความคิดเห็นทั้งหมด และคุณต้องใช้เมธอด comments.list
หากต้องการเรียกการตอบกลับทั้งหมดสําหรับความคิดเห็นหนึ่งๆ โปรดทราบว่าความคิดเห็นบางรายการไม่มีการตอบกลับ
วิธีการ
API รองรับวิธีต่อไปนี้สําหรับทรัพยากร commentThreads
รายการ
- list
- แสดงผลรายการชุดข้อความความคิดเห็นที่ตรงกับพารามิเตอร์คําขอ API ลองใช้เลย
- แทรก
- สร้างความคิดเห็นระดับบนสุดใหม่ หากต้องการเพิ่มการตอบกลับความคิดเห็นที่มีอยู่ ให้ใช้เมธอด
comments.insert
แทน ลองใช้เลย
การนําเสนอแหล่งข้อมูล
โครงสร้าง JSON ด้านล่างแสดงรูปแบบทรัพยากร commentThreads
ดังนี้
{ "kind": "youtube#commentThread", "etag": etag, "id": string, "snippet": { "channelId": string, "videoId": string, "topLevelComment": comments Resource, "canReply": boolean, "totalReplyCount": unsigned integer, "isPublic": boolean }, "replies": { "comments": [ comments Resource ] } }
พร็อพเพอร์ตี้
ตารางต่อไปนี้กําหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
kind |
string ระบุประเภทของทรัพยากร API ค่านี้จะเป็น youtube#commentThread |
etag |
etag Etag ของทรัพยากรนี้ |
id |
string รหัสที่ YouTube ใช้ในการระบุชุดข้อความของความคิดเห็นแบบไม่ซ้ํา |
snippet |
object ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับชุดความคิดเห็น และยังมีความคิดเห็นระดับบนสุดของชุดข้อความ ซึ่งเป็นทรัพยากร comment |
snippet.channelId |
string ช่อง YouTube ที่เชื่อมโยงกับความคิดเห็นในชุดข้อความ (พร็อพเพอร์ตี้ snippet.videoId ระบุวิดีโอ)
|
snippet.videoId |
string รหัสของวิดีโอที่ความคิดเห็นอ้างถึง หากมี หากพร็อพเพอร์ตี้นี้ไม่มีอยู่หรือไม่มีค่า ระบบจะใช้ชุดข้อความกับช่อง ไม่ใช่กับวิดีโอใดวิดีโอหนึ่ง |
snippet.topLevelComment |
object ความคิดเห็นระดับบนสุดของชุดข้อความ ค่าของพร็อพเพอร์ตี้เป็นทรัพยากร comment |
snippet.canReply |
boolean การตั้งค่านี้ระบุว่าผู้ชมปัจจุบันตอบกลับชุดข้อความได้หรือไม่ |
snippet.totalReplyCount |
unsigned integer จํานวนการตอบกลับทั้งหมดที่ส่งเพื่อตอบกลับความคิดเห็นระดับบนสุด |
snippet.isPublic |
boolean การตั้งค่านี้ระบุว่าผู้ใช้ YouTube ทุกคนจะเห็นชุดข้อความ รวมถึงความคิดเห็นและการตอบกลับของความคิดเห็นทั้งหมดหรือไม่ |
replies |
object ออบเจ็กต์ replies คือคอนเทนเนอร์ที่มีรายการการตอบกลับความคิดเห็น (หากมี) พร็อพเพอร์ตี้ replies.comments จะแสดงรายการความคิดเห็น |
replies.comments[] |
list รายการการตอบกลับความคิดเห็นระดับบนสุดอย่างน้อย 1 รายการ แต่ละรายการในลิสต์เป็นทรัพยากร comment รายการนี้มีการตอบกลับจํานวนจํากัด และเว้นแต่จํานวนรายการในลิสต์จะเท่ากับค่าของพร็อพเพอร์ตี้ snippet.totalReplyCount รายการการตอบกลับเป็นเพียงชุดย่อยของจํานวนการตอบกลับทั้งหมดที่มีให้สําหรับความคิดเห็นระดับบนสุด หากต้องการเรียกการตอบกลับทั้งหมดสําหรับความคิดเห็นระดับบนสุด คุณต้องเรียกใช้เมธอด comments.list และใช้พารามิเตอร์คําขอ parentId เพื่อระบุความคิดเห็นที่ต้องการเรียกดูการตอบกลับ |