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 ชั่วโมงหลังจากดึงข้อมูล