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

ไม่รองรับเมธอด 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 อาจมีความคิดเห็นเกี่ยวกับช่องหรือวิดีโอใดๆ ของช่อง

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

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

คำขอด้านล่างดึงชุดข้อความความคิดเห็นทั้งหมดที่เชื่อมโยงกับช่อง 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 Explorer ให้ใช้ค่าของพร็อพเพอร์ตี้ 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 Explorer ให้ตั้งค่าของพร็อพเพอร์ตี้ 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 Explorer คุณจะต้องแทนที่รหัสความคิดเห็นหรือรหัสชุดความคิดเห็นที่ถูกต้องสำหรับค่าพารามิเตอร์ id ในคำขอด้านล่าง

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