Perubahan komentar di YouTube Data API v2 lama

Jeremy Walker, Tim YouTube API
September 2013 (diperbarui 12/02/2013)

Pengantar

Sistem komentar YouTube baru, yang diluncurkan pada November 2013 dan didukung oleh Google+, memungkinkan pengguna YouTube mengambil lebih banyak komentar per video dibandingkan sebelumnya. Sistem yang baru juga memudahkan pengguna untuk menemukan percakapan yang bermakna, karena komentar diurutkan berdasarkan relevansi dengan setiap pengguna.

Meskipun komentar baru saat ini tidak didukung di YouTube Data API v3, Anda dapat terus menggunakan API versi lama (v2) dengan beberapa pengecualian yang diuraikan di bawah (dan manfaat yang dibahas di atas).

Sebaiknya konfirmasi bahwa integrasi Anda terus berfungsi setelah kami beralih ke sistem komentar baru dan beri tahu kami jika Anda menemukan bug (masalah file di youtube.com/dev). Terima kasih.

Pertanyaan Umum (FAQ)

Apa yang terjadi pada komentar yang diposting sebelum transisi?

Komentar yang diposting sebelum transisi telah dimigrasikan ke sistem baru yang didukung oleh Google+.

Apakah feed komentar masih tersedia?

Ya, misalnya, jika Anda menggunakan API untuk mengambil komentar untuk video, Anda akan mendapatkan feed komentar yang diurutkan berdasarkan relevansi seperti yang disebutkan dalam pengumuman.* Sejak peralihan ke sistem komentar baru, komentar tidak lagi berada dalam urutan kronologis secara default. Namun, Anda masih dapat mengurutkan komentar secara kronologis dengan menyetel nilai parameter orderby ke published dalam permintaan API seperti ditunjukkan dalam contoh berikut:

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

Sebaiknya ikuti praktik terbaik standar untuk menggunakan link next dan previous di feed komentar untuk membuka halaman melalui komentar. Dengan demikian, Anda juga akan mendapatkan manfaat tambahan berupa kemampuan untuk melihat lebih banyak komentar daripada sebelumnya.

Jika Anda menetapkan nilai untuk start-index secara eksplisit untuk memuat feed komentar secara bergulir (tidak direkomendasikan), hal ini dapat menyebabkan perilaku yang tidak konsisten dan Anda hanya akan mendapatkan sedikit komentar yang ditampilkan.

Pembaruan (10/11/2013):

* Secara default, feed komentar diurutkan berdasarkan relevansi umum, bukan relevansi pribadi. Dengan kata lain, permintaan feed komentar yang diautentikasi dan tidak diautentikasi akan menampilkan hasil yang sama. API ini mendukung feed komentar yang dipersonalisasi yang menyertakan postingan non-publik. Untuk mendapatkan feed ini, cukup buat permintaan yang diautentikasi dan tetapkan nilai parameter relevant-to-me ke true dalam permintaan API Anda seperti yang ditunjukkan dalam contoh berikut: 

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

Apakah ada feed yang menunjukkan format feed baru?

Semua feed komentar kini mendukung format baru. Beberapa contohnya ada di bawah.

  • Feed berbasis relevansi: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Feed berbasis kronologi: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Apakah saya masih dapat membuat komentar melalui API?

Ya, tetapi untuk menulis komentar baru dengan v2 API, ada beberapa persyaratan:

  1. Pengguna yang diautentikasi harus memiliki channel YouTube yang ditautkan ke akun Google+ (detail API)
  2. Permintaan harus dikirim melalui HTTPS (library klien lama versi saat ini mendukungnya secara default)

Jika salah satu persyaratan ini tidak terpenuhi, API akan menampilkan error.

Komentar yang didukung Google+ menawarkan rangkaian komentar. Apa pengaruhnya terhadap balasan komentar YouTube?

Balasan komentar yang dibuat sebelum transisi kini muncul sebagai komentar biasa. Selain itu, membalas komentar secara langsung melalui YouTube API tidak lagi didukung. Saat ini, tidak ada cara untuk membalas komentar bergaya baru melalui YouTube API.

Balasan untuk komentar YouTube gaya baru melalui situs dan aplikasi YouTube serta Google+ tidak ditampilkan dengan feed komentar API lama. Namun, Anda bisa mendapatkan balasan sebenarnya melalui Google+ API.

Jika entri feed komentar YouTube mewakili komentar bergaya baru, entri tersebut akan berisi tag <yt:googlePlusUserId>. Jika tag tersebut ada dan komentar memiliki balasan (cukup periksa elemen <yt:replyCount>), Anda dapat mengurai ID Aktivitas Google+ dari tag <id> entri. Anda dapat menggunakan ID tersebut untuk memanggil metode comments:list Google+ API guna mengambil daftar balasan terbaru untuk komentar tersebut.

Cuplikan di bawah ini menunjukkan bagaimana ID Aktivitas Google+, yang ditampilkan dalam teks tebal, muncul dalam entri feed komentar:

<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>

Apa yang terjadi di Google+ saat saya membuat komentar melalui YouTube API?

Membuat komentar melalui YouTube API tidak akan menghasilkan postingan di feed Google+ Anda atau membuat notifikasi Google+.

Apakah komentar terus muncul di feed aktivitas sejak beralih ke sistem komentar baru?

Tidak untuk saat ini.

Apakah SUP di API lama terus berfungsi untuk komentar?

Tidak, bukan untuk komentar. SUP bergantung pada feed aktivitas pengguna. Karena tidak lagi ada di feed aktivitas, komentar tersebut tidak akan muncul di SUP.