Comments

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

เมธอด

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

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