Comments

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

เมธอด

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

list
แสดงผลรายการความคิดเห็นที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
แทรก
สร้างคำตอบสำหรับความคิดเห็นที่มีอยู่ หมายเหตุ: หากต้องการสร้างความคิดเห็นระดับบนสุด ให้ใช้วิธีcommentThreads.insert ลองเลย
update
แก้ไขความคิดเห็น ลองใช้เลย
ลบ
ลบความคิดเห็น ลองใช้เลย
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,
    "imageUrl": string
  }
}

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

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในแหล่งข้อมูลนี้

พร็อพเพอร์ตี้
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
snippet.imageUrl string
URL ของรูปภาพหรือ GIF ภาพเคลื่อนไหวที่แนบมากับความคิดเห็น (หากมี) พร็อพเพอร์ตี้นี้จะปรากฏเมื่อความคิดเห็นมีรูปภาพหรือ GIF เท่านั้น URL จะแสดงเป็นลิงก์ที่ลงนามพร้อม Time to Live (TTL) 6 ชั่วโมง และจะหมดอายุ 6 ชั่วโมงหลังจากดึงข้อมูล