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

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

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

ดึงข้อมูลความคิดเห็นสำหรับวิดีโอ

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

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

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

คำขอต่อไปนี้จะดึงข้อมูลความคิดเห็นและการตอบกลับความคิดเห็นที่เกี่ยวข้องกับวิดีโอคำปราศรัยในงาน Google I/O Conference ปี 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