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