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