หน้านี้ได้รับการแปลโดย Cloud Translation API

Comments

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

วิธีการ

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

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

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

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร comments

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "videoId": 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.videoId` จะระบุวิดีโอ หากความคิดเห็นนั้นเป็นความคิดเห็นเกี่ยวกับช่อง พร็อพเพอร์ตี้นี้จะระบุช่องที่เกี่ยวข้องกับความคิดเห็นดังกล่าว
`snippet.videoId`	`string` รหัสของวิดีโอที่ความคิดเห็นดังกล่าวอ้างถึง คุณสมบัตินี้จะปรากฏก็ต่อเมื่อมีการแสดงความคิดเห็นในวิดีโอเท่านั้น
`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