CommentThreads

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