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