การเปลี่ยนแปลงความคิดเห็นใน YouTube Data API เวอร์ชัน 2 เดิม

Jeremy Walker จากทีม YouTube API
กันยายน 2013 (อัปเดต 2/12/2013)

บทนำ

ระบบการแสดงความคิดเห็นแบบใหม่ของ YouTube ซึ่งเปิดตัวไปเมื่อเดือนพฤศจิกายน 2013 และทำงานด้วย Google+ ช่วยให้ผู้ใช้ YouTube เรียกดูความคิดเห็นต่อวิดีโอได้มากขึ้นกว่าที่เคย ระบบใหม่นี้ยังช่วยให้คุณค้นหาการสนทนาที่มีความหมายได้ง่ายขึ้นด้วย เนื่องจากระบบจะจัดเรียงความคิดเห็นตามความเกี่ยวข้องกับผู้ใช้แต่ละราย

แม้ว่า YouTube Data API เวอร์ชัน 3 ยังไม่รองรับความคิดเห็นแบบใหม่ แต่คุณยังคงใช้ API เวอร์ชันเก่า (เวอร์ชัน 2) ต่อไปได้โดยมีข้อควรระวังบางอย่างที่ระบุไว้ด้านล่าง (และประโยชน์ที่ระบุไว้ข้างต้น)

เราขอแนะนำให้คุณตรวจสอบว่าการผสานรวมยังคงทำงานต่อไปได้หรือไม่หลังจากที่เราเปลี่ยนไปใช้ระบบการคอมเมนต์แบบใหม่ และแจ้งให้เราทราบหากพบข้อบกพร่อง (รายงานปัญหาที่ youtube.com/dev) ขอขอบคุณ

คำถามที่พบบ่อย

เกิดอะไรขึ้นกับความคิดเห็นที่โพสต์ก่อนการเปลี่ยนแปลง

ความคิดเห็นที่โพสต์ก่อนการเปลี่ยนแปลงได้ย้ายข้อมูลไปยังระบบใหม่ที่ทำงานด้วย Google+ แล้ว

ฟีดความคิดเห็นยังมีอยู่ไหม

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

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

เราขอแนะนำให้คุณทำตามแนวทางปฏิบัติแนะนำมาตรฐานในการใช้ลิงก์ next และ previous ในฟีดความคิดเห็นเพื่อเลื่อนดูความคิดเห็น การทำเช่นนี้จะทำให้คุณได้รับประโยชน์เพิ่มเติม เพราะสามารถเรียกดูหน้าความคิดเห็นได้มากกว่าที่เคย

หากคุณตั้งค่า start-index อย่างชัดเจนเพื่อเลื่อนดูฟีดความคิดเห็น (ไม่แนะนำ) อาจทําให้ลักษณะการทํางานไม่สอดคล้องกันและคุณจะได้รับความคิดเห็นเพียงจํานวนน้อยเท่านั้น

อัปเดต (10/11/2013):

* โดยค่าเริ่มต้น ฟีดความคิดเห็นจะจัดเรียงตามความเกี่ยวข้องทั่วไป ไม่ใช่ความเกี่ยวข้องส่วนบุคคล กล่าวคือ คำขอฟีดความคิดเห็นที่มีการตรวจสอบสิทธิ์และไม่ตรวจสอบสิทธิ์จะให้ผลลัพธ์เดียวกัน API รองรับฟีดความคิดเห็นที่ปรับเปลี่ยนในแบบของคุณ ซึ่งมีโพสต์ที่ไม่ใช่แบบสาธารณะ หากต้องการรับฟีดนี้ เพียงส่งคำขอการตรวจสอบสิทธิ์และตั้งค่าของพารามิเตอร์ relevant-to-me เป็น true ในคำขอ API ดังที่ปรากฏในตัวอย่างต่อไปนี้ 

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true

มีฟีดที่แสดงรูปแบบของฟีดใหม่ไหม

ฟีดความคิดเห็นทั้งหมดรองรับรูปแบบใหม่แล้วในตอนนี้ ตัวอย่างบางส่วนมีดังนี้

  • ฟีดตามความเกี่ยวข้อง 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • ฟีดที่จัดเรียงตามลำดับเวลา: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

ฉันจะยังสร้างความคิดเห็นผ่าน API ได้ไหม

ได้ แต่ในการแสดงความคิดเห็นใหม่ด้วย API เวอร์ชัน 2 นั้น มีข้อกำหนดหลายประการดังนี้

  1. ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วต้องมีช่อง YouTube ที่ลิงก์กับบัญชี Google+ (รายละเอียด API)
  2. คำขอต้องส่งผ่าน HTTPS (ไลบรารีของไคลเอ็นต์เดิมเวอร์ชันปัจจุบันรองรับโดยค่าเริ่มต้น)

หากไม่เป็นไปตามข้อกำหนดข้อใดข้อหนึ่ง API จะแสดงข้อผิดพลาด

ความคิดเห็นที่ทำงานด้วย Google+ มีการแสดงความคิดเห็นเป็นชุดข้อความ สิ่งนี้จะมีผลอย่างไรต่อการตอบกลับความคิดเห็นใน YouTube

การตอบกลับความคิดเห็นที่เขียนขึ้นก่อนการเปลี่ยนแปลงจะปรากฏเป็นความคิดเห็นปกติ นอกจากนี้ ระบบไม่รองรับการตอบกลับความคิดเห็นโดยตรงผ่าน YouTube API อีกต่อไป ขณะนี้ยังไม่มีวิธีตอบกลับความคิดเห็นรูปแบบใหม่ผ่าน YouTube API

การตอบกลับความคิดเห็นสไตล์ใหม่ของ YouTube ผ่านเว็บไซต์และแอป YouTube และ Google+ จะไม่แสดงพร้อมกับฟีดความคิดเห็นของ API รุ่นเดิม แต่คุณดูคำตอบจริงได้ผ่าน Google+ API

หากรายการฟีดความคิดเห็นของ YouTube แสดงความคิดเห็นรูปแบบใหม่ รายการดังกล่าวจะมีแท็ก <yt:googlePlusUserId> หากมีแท็กดังกล่าวและความคิดเห็นมีการตอบกลับ (เพียงตรวจสอบองค์ประกอบ <yt:replyCount>) คุณจะแยกวิเคราะห์รหัสกิจกรรม Google+ ได้จากแท็ก <id> ของรายการ คุณสามารถใช้รหัสดังกล่าวเพื่อเรียกใช้เมธอด comments:list ของ Google+ API เพื่อเรียกข้อมูลรายการการตอบล่าสุดสำหรับความคิดเห็นนั้น

ข้อความด้านล่างนี้แสดงให้เห็นว่ารหัสกิจกรรม Google+ ซึ่งแสดงเป็นตัวหนาปรากฏในรายการฟีดความคิดเห็นอย่างไร

<entry>
  <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id>
  <yt:googlePlusUserId>123456789</yt:googlePlusUserId>
  <yt:replyCount>4</yt:replyCount>
  <yt:channelId>UCxxxx_xxxxx</yt:channelId>
  ...
</entry>

จะเกิดอะไรขึ้นใน Google+ เมื่อฉันแสดงความคิดเห็นผ่าน API ของ YouTube

การแสดงความคิดเห็นผ่าน API ของ YouTube ไม่ได้เป็นการสร้างโพสต์ในสตรีม Google+ ของคุณหรือไม่ได้เป็นการสร้างการแจ้งเตือน Google+ แต่อย่างใด

ความคิดเห็นจะยังปรากฏในฟีดกิจกรรมต่อไปไหมหลังจากเปลี่ยนไปใช้ระบบการแสดงความคิดเห็นแบบใหม่

ไม่ในขณะนี้

ฟีเจอร์ SUP ใน API เดิมจะใช้งานสําหรับความคิดเห็นต่อไปไหม

ไม่ ใช้สำหรับความคิดเห็น SUP อาศัยฟีดกิจกรรมของผู้ใช้ เนื่องจากความคิดเห็นไม่ได้อยู่ในฟีดกิจกรรมอีกต่อไป ความคิดเห็นจึงไม่แสดงใน SUP