การใช้งาน: ความคิดเห็น

ระบบไม่รองรับเมธอด comments.markAsSpam อีกต่อไป

ตัวอย่างต่อไปนี้แสดงวิธีใช้ YouTube Data API (v3) เพื่อดำเนินการที่เกี่ยวข้องกับความคิดเห็น

ดึงข้อมูลความคิดเห็นของวิดีโอ

หากต้องการเรียกข้อมูลรายการชุดข้อความของความคิดเห็นสำหรับวิดีโอ ให้เรียกใช้เมธอด commentThreads.list ตั้งค่าพารามิเตอร์ต่อไปนี้ในคำขอ

• part: ตั้งค่าพารามิเตอร์เป็น snippet หากต้องการดึงข้อมูลความคิดเห็นระดับบนสุดเท่านั้น หรือเป็น snippet,replies หากต้องการดึงข้อมูลการตอบกลับความคิดเห็นระดับบนสุดด้วย (โปรดทราบว่าแหล่งข้อมูล commentThread ไม่จำเป็นต้องมีการตอบกลับทั้งหมดสำหรับความคิดเห็นหนึ่งๆ และคุณต้องใช้เมธอด comments.list หากต้องการดึงข้อมูลการตอบกลับทั้งหมดสำหรับความคิดเห็นหนึ่งๆ)

• videoId: ระบุรหัสวิดีโอ YouTube ของวิดีโอที่คุณต้องการดึงข้อมูลความคิดเห็น

คำขอด้านล่างจะดึงข้อมูลความคิดเห็นและการตอบกลับความคิดเห็นที่เกี่ยวข้องกับวิดีโอของคําปราศรัยสําคัญในการประชุม Google I/O ปี 2014 ซึ่งมีรหัสวิดีโอ wtLJPvx7-ys

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&videoId=wtLJPvx7-ys

ดึงข้อมูลความคิดเห็นเกี่ยวกับหรือเชื่อมโยงกับช่อง

API รองรับความสามารถในการเรียกชุดความคิดเห็นเกี่ยวกับช่องหรือเรียกชุดความคิดเห็นทั้งหมดที่เชื่อมโยงกับช่อง ในกรณีหลัง API อาจประกอบด้วยความคิดเห็นเกี่ยวกับช่องหรือเกี่ยวกับวิดีโอของช่อง

• หากต้องการเรียกข้อมูลความคิดเห็นเกี่ยวกับช่อง ให้ทำตามวิธีการการเรียกข้อมูลความคิดเห็นสำหรับวิดีโอ แต่ให้ตั้งค่าพารามิเตอร์ channelId เพื่อระบุแชแนลแทนการตั้งค่าพารามิเตอร์ videoId

• หากต้องการเรียกข้อมูลความคิดเห็นที่เชื่อมโยงกับช่อง ให้ทำตามวิธีการเรียกข้อมูลความคิดเห็นของวิดีโอ แต่ให้ตั้งค่าพารามิเตอร์ allThreadsRelatedToChannelId เพื่อระบุแชแนลแทนการตั้งค่าพารามิเตอร์ videoId

คำขอด้านล่างจะดึงข้อมูลชุดข้อความความคิดเห็นทั้งหมดที่เชื่อมโยงกับช่อง YouTube ของ GoogleDevelopers

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&allThreadsRelatedToChannelId=UC_x5XG1OV2P6uZZ5FSM9Ttw

กำลังเพิ่มความคิดเห็น

เรียกใช้เมธอด commentThreads.insert เพื่อเพิ่มความคิดเห็นระดับบนสุดใหม่ลงในช่องหรือวิดีโอ ตั้งค่าพารามิเตอร์ part ของคําขอเป็น snippet เนื้อความของคําขอคือ commentThread resource ซึ่งพร็อพเพอร์ตี้ snippet.topLevelComment[].snippet[].textOriginal มีข้อความความคิดเห็น คำขอนี้ต้องได้รับสิทธิ์โดยใช้ OAuth 2.0

• หากต้องการเพิ่มความคิดเห็นในช่อง ให้ใช้พร็อพเพอร์ตี้ snippet.channelId เพื่อระบุช่อง
• หากต้องการเพิ่มความคิดเห็นในวิดีโอ ให้ใช้พร็อพเพอร์ตี้ snippet.channelId เพื่อระบุช่องที่อัปโหลดวิดีโอ รวมถึงใช้พร็อพเพอร์ตี้ snippet.videoId เพื่อระบุวิดีโอด้วย

ตัวอย่างคำขอต่อไปนี้จะเพิ่มความคิดเห็นลงในวิดีโอ

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.insert?
part=snippet

คําขอจะแทรกทรัพยากรที่แสดงด้านล่าง

{
 "snippet": {
  "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "topLevelComment": {
   "snippet": {
    "textOriginal": "This video is awesome!"
   }
  },
  "videoId": "MILSirUni5E"
 }
}

ตอบกลับความคิดเห็น

เรียกใช้เมธอด comments.insert เพื่อตอบกลับความคิดเห็น ตั้งค่าพารามิเตอร์ part ของคําขอเป็น snippet เนื้อความของคําขอคือ comment resource ซึ่งพร็อพเพอร์ตี้ snippet.textOriginal มีข้อความความคิดเห็น พร็อพเพอร์ตี้ snippet.parentId จะระบุความคิดเห็นที่เชื่อมโยงกับการตอบกลับ และค่าของพร็อพเพอร์ตี้นี้คือ commentThread resource's ID คำขอนี้ต้องได้รับสิทธิ์โดยใช้ OAuth 2.0

ตัวอย่างคำขอต่อไปนี้จะเพิ่มการตอบกลับความคิดเห็นที่มีอยู่

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.insert?
part=snippet

คําขอจะแทรกทรัพยากรที่แสดงด้านล่าง หากต้องการเรียกใช้คําขอในเครื่องมือสํารวจ API ให้ใช้ค่าของพร็อพเพอร์ตี้ snippet.parentId เพื่อระบุความคิดเห็นระดับบนสุดที่เชื่อมโยงกับการตอบกลับ ในทรัพยากร commentThread พร็อพเพอร์ตี้ snippet.topLevelComment[].id จะระบุรหัสที่ไม่ซ้ำของทรัพยากร

{
  "snippet": {
    "parentId": "COMMENT_THREAD_ID",
    "textOriginal": "That is true."
  }
}

อัปเดตความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็น

หากต้องการอัปเดตข้อความของความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็นระดับบนสุด ให้เรียกใช้เมธอด comments.update ตั้งค่าพารามิเตอร์ part เป็น snippet ในเนื้อหาคําขอ พร็อพเพอร์ตี้ id จะระบุความคิดเห็นที่คุณแก้ไขและข้อความความคิดเห็นใหม่

• ในทรัพยากร commentThread ซึ่งระบุความคิดเห็นระดับบนสุด พร็อพเพอร์ตี้ snippet.topLevelComment[].id จะระบุรหัสที่ไม่ซ้ำกันของความคิดเห็น
• ในทรัพยากร comment ซึ่งระบุความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็น พร็อพเพอร์ตี้ id จะระบุรหัสที่ไม่ซ้ำของความคิดเห็น

คําขอตัวอย่างด้านล่างจะอัปเดตข้อความของความคิดเห็นที่มีอยู่

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.update?
part=snippet

เนื้อหาของคำขอมีข้อมูลโค้ด JSON ที่แสดงด้านล่าง หากต้องการเรียกใช้คําขอในเครื่องมือสํารวจ API ให้ตั้งค่าของพร็อพเพอร์ตี้ id เพื่อระบุความคิดเห็นที่คุณกําลังอัปเดต ผู้เขียนความคิดเห็นต้องให้สิทธิ์คำขอ

{
  "id": "COMMENT_ID",
  "snippet": {
    "textOriginal": "That is true."
  }
}

ตั้งค่าสถานะการดูแลความคิดเห็น

หากต้องการตั้งค่าสถานะการดูแลความคิดเห็น ให้เรียกใช้เมธอด comments.setModerationStatus การดำเนินการนี้จะใช้ได้เมื่อเจ้าของช่องดูแลความคิดเห็นในช่องหรือวิดีโอของช่อง

เมื่อเรียกใช้เมธอดนี้ ให้ตั้งค่าพารามิเตอร์ id เพื่อระบุความคิดเห็น และตั้งค่าพารามิเตอร์ moderationStatus เป็นสถานะที่ต้องการด้วย เจ้าของช่องที่ความคิดเห็นปรากฏอยู่เท่านั้นที่จะปรับสถานะของความคิดเห็นได้

• ขั้นตอนที่ 1: เรียกข้อมูลความคิดเห็นที่ถูกระงับเพื่อรอตรวจสอบ

  เรียกใช้เมธอด commentThreads.list เพื่อดึงข้อมูลความคิดเห็นของช่องหรือวิดีโอ ตั้งค่าพารามิเตอร์ moderationStatus เป็น heldForReview การตอบกลับของ API อาจใช้เพื่อแสดงรายการความคิดเห็นพร้อมตัวเลือกให้เจ้าของช่องเผยแพร่หรือปฏิเสธความคิดเห็นแต่ละรายการ

• ขั้นตอนที่ 2: อัปเดตสถานะการดูแลของความคิดเห็น

  เรียกใช้เมธอด comments.setModerationStatus เพื่ออัปเดตสถานะของความคิดเห็น ใช้ค่าของพารามิเตอร์ id เพื่อระบุรหัสที่ไม่ซ้ำของความคิดเห็น ตั้งค่าพารามิเตอร์ moderationStatus เป็น published หรือ rejected หากต้องการปฏิเสธความคิดเห็น คุณยังตั้งค่าพารามิเตอร์ banAuthor เป็น true เพื่อป้องกันไม่ให้ผู้เขียนแสดงความคิดเห็นเพิ่มเติมในช่องหรือวิดีโอได้ด้วย

หมายเหตุ: API ไม่มีวิธีแสดงรายการหรือค้นหาความคิดเห็นที่ถูกปฏิเสธ อย่างไรก็ตาม คุณจะยังคงเปลี่ยนสถานะการดูแลความคิดเห็นที่ถูกปฏิเสธเป็น published ได้หากทราบรหัสที่ไม่ซ้ำกันของความคิดเห็น นอกจากนี้ เมื่ออัปเดตสถานะการดูแลความคิดเห็นเป็น published หรือ rejected แล้ว คุณจะเปลี่ยนสถานะการดูแลกลับไปเป็น heldForReview ไม่ได้

นำความคิดเห็นออก

ตัวอย่างนี้แสดงวิธีลบความคิดเห็น ตัวอย่างนี้มีขั้นตอนดังนี้

• ขั้นตอนที่ 1: เรียกข้อมูลรหัสความคิดเห็น

  ทำตามขั้นตอนด้านบนเพื่อดึงข้อมูลรายการความคิดเห็นของวิดีโอหรือช่อง โปรดทราบว่าผู้เขียนเท่านั้นที่ลบความคิดเห็นได้ คุณจึงต้องเปรียบเทียบค่าของพร็อพเพอร์ตี้ snippet.authorChannelId.value ของcomment ทรัพยากรกับรหัสช่องของผู้ใช้ที่ตรวจสอบสิทธิ์เพื่อดูว่าผู้ใช้สามารถลบความคิดเห็นนั้นๆ ได้หรือไม่

• ขั้นตอนที่ 2: ลบความคิดเห็นหรือชุดข้อความของความคิดเห็น

  เมื่อระบุรหัสของชุดความคิดเห็นหรือความคิดเห็นที่จะลบแล้ว ให้เรียกใช้เมธอด comments.delete เพื่อลบความคิดเห็นนั้น ใช้ค่าพารามิเตอร์ id เพื่อระบุรหัสความคิดเห็นหรือรหัสชุดข้อความความคิดเห็นที่คุณกำลังจะลบ คำขอต้องได้รับสิทธิ์โดยใช้ OAuth 2.0 หากคุณทดสอบการค้นหานี้ในโปรแกรมสำรวจ API คุณจะต้องแทนที่ค่าพารามิเตอร์ id ในคำขอด้านล่างด้วยรหัสความคิดเห็นหรือรหัสชุดข้อความความคิดเห็นที่ถูกต้อง

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.comments.delete?
  id=COMMENT_ID