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