แหล่งข้อมูล 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 เพื่อระบุความคิดเห็นที่คุณต้องการเรียกคืนการตอบกลับ |