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