Comments

ทรัพยากร comment มีข้อมูลเกี่ยวกับความคิดเห็น YouTube รายการเดียว comment แหล่งข้อมูลอาจแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่อง นอกจากนี้ ความคิดเห็นยังอาจเป็นความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็นระดับบนสุดก็ได้

เมธอด

API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร comments

list

แสดงรายการความคิดเห็นที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย

แทรก

สร้างการตอบกลับความคิดเห็นที่มีอยู่ หมายเหตุ: หากต้องการสร้างความคิดเห็นระดับบนสุด ให้ใช้วิธี commentThreads.insert ลองใช้เลย

อัปเดต

แก้ไขความคิดเห็น ลองใช้เลย

ลบ

ลบความคิดเห็น ลองใช้เลย

setModerationStatus

ตั้งค่าสถานะการดูแลของความคิดเห็นอย่างน้อย 1 รายการ เจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็นต้องให้สิทธิ์คำขอ API ลองใช้เลย

การแสดงทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร comments

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้กำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind	string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#comment
etag	etag Etag ของทรัพยากรนี้
id	string รหัสที่ YouTube ใช้เพื่อระบุความคิดเห็นที่ไม่ซ้ำกัน
snippet	object ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับความคิดเห็น
snippet.authorDisplayName	string ชื่อที่แสดงของผู้ใช้ที่โพสต์ความคิดเห็น
snippet.authorProfileImageUrl	string URL ของรูปโปรไฟล์ของผู้ใช้ที่โพสต์ความคิดเห็น
snippet.authorChannelUrl	string URL ของช่อง YouTube ของผู้เขียนความคิดเห็น หากมี
snippet.authorChannelId	object ออบเจ็กต์นี้ห่อหุ้มข้อมูลเกี่ยวกับช่อง YouTube ของผู้เขียนความคิดเห็น หากมี
snippet.authorChannelId.value	string รหัสช่อง YouTube ของผู้เขียนความคิดเห็น หากมี
snippet.channelId	string รหัสของช่อง YouTube ที่เชื่อมโยงกับความคิดเห็น
snippet.textDisplay	string ข้อความของความคิดเห็น โดยสามารถดึงข้อความได้ทั้งในรูปแบบข้อความธรรมดาหรือ HTML (ทั้งวิธี comments.list และ commentThreads.list รองรับพารามิเตอร์ textFormat ซึ่งระบุรูปแบบข้อความที่เลือก) แม้แต่ข้อความธรรมดาก็อาจแตกต่างจากข้อความความคิดเห็นเดิม เช่น อาจแทนที่ลิงก์วิดีโอด้วยชื่อวิดีโอ
snippet.textOriginal	string ข้อความเดิมแบบดิบของความคิดเห็นตามที่โพสต์ครั้งแรกหรืออัปเดตล่าสุด ระบบจะแสดงข้อความต้นฉบับต่อผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ก็ต่อเมื่อผู้ใช้เป็นผู้เขียนความคิดเห็นเท่านั้น
snippet.parentId	string รหัสที่ไม่ซ้ำกันของความคิดเห็นหลัก ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้ก็ต่อเมื่อมีการส่งความคิดเห็นเป็นการตอบกลับความคิดเห็นอื่น
snippet.canRate	boolean การตั้งค่านี้จะระบุว่าผู้ชมปัจจุบันให้คะแนนความคิดเห็นได้หรือไม่
snippet.viewerRating	string คะแนนที่ผู้ชมให้ความคิดเห็นนี้ พร็อพเพอร์ตี้นี้ไม่ได้ระบุการจัดประเภท dislike แม้ว่าลักษณะการทำงานนี้อาจเปลี่ยนแปลงได้ ในระหว่างนี้ ค่าพร็อพเพอร์ตี้จะเป็น like หากผู้ชมให้คะแนนความคิดเห็นเป็นบวก ค่าจะเป็น none ในกรณีอื่นๆ ทั้งหมด รวมถึงกรณีที่ผู้ใช้ให้คะแนนความคิดเห็นเป็นลบหรือไม่ได้ให้คะแนนความคิดเห็น ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ like none
snippet.likeCount	unsigned integer จำนวนการกดชอบทั้งหมด (การให้คะแนนเชิงบวก) ที่ความคิดเห็นได้รับ
snippet.moderationStatus	string สถานะการกลั่นกรองความคิดเห็น ระบบจะแสดงผลพร็อพเพอร์ตี้นี้ก็ต่อเมื่อเจ้าของช่องหรือวิดีโอที่มีการแสดงความคิดเห็นที่ขออนุมัติคำขอ API นอกจากนี้ ระบบจะไม่ตั้งค่าพร็อพเพอร์ตี้นี้หากคำขอ API ใช้idพารามิเตอร์ตัวกรอง ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้ heldForReview likelySpam published rejected
snippet.publishedAt	datetime วันที่และเวลาที่เผยแพร่ความคิดเห็นครั้งแรก โดยค่าจะระบุในรูปแบบ ISO 8601
snippet.updatedAt	datetime วันที่และเวลาที่อัปเดตความคิดเห็นครั้งล่าสุด โดยค่าจะระบุในรูปแบบ ISO 8601