Comments

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

เมธอด

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

list
แสดงรายการความคิดเห็นที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
แทรก
สร้างการตอบกลับความคิดเห็นที่มีอยู่ หมายเหตุ: หากต้องการสร้างความคิดเห็นระดับบนสุด ให้ใช้เมธอด commentThreads.insert ลองใช้เลย
update
แก้ไขความคิดเห็น ลองใช้เลย
ลบ
ลบความคิดเห็น ลองใช้เลย
setModerationStatus
ตั้งค่าสถานะการดูแลความคิดเห็นอย่างน้อย 1 รายการ คำขอ API ต้องได้รับอนุญาตจากเจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็น ลองใช้เลย
markAsSpam
หมายเหตุ: ระบบเลิกใช้งานวิธีการนี้แล้วและไม่รองรับอีกต่อไป
แสดงความคิดเห็นของผู้โทรว่าควรแจ้งว่าความคิดเห็นอย่างน้อย 1 รายการเป็นสแปม

การนําเสนอทรัพยากร

โครงสร้าง 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