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