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 baru ini juga mempermudah Anda 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 peringatan yang diuraikan di bawah (dan manfaat yang tercakup 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 menggunakan link next dan previous di feed komentar untuk melihat halaman melalui komentar. Dengan melakukan hal itu, Anda juga akan mendapatkan manfaat tambahan yaitu dapat melakukan page melalui lebih banyak komentar daripada sebelumnya.

Jika Anda secara eksplisit menetapkan nilai untuk start-index untuk halaman melalui feed komentar (tidak direkomendasikan), hal ini dapat menyebabkan perilaku yang tidak konsisten dan Anda hanya akan mendapatkan sejumlah kecil komentar.

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. Berikut beberapa contohnya.

  • 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 pesan. Apa pengaruhnya bagi 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 YouTube dan situs Google+ dan aplikasi tidak ditampilkan dengan feed komentar API lama. Namun, Anda bisa mendapatkan balasan sebenarnya melalui Google+ API.

Jika entri feed komentar YouTube mewakili komentar gaya 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+ jika saya memberi 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, tidak untuk komentar. SUP bergantung pada feed aktivitas pengguna. Karena komentar tidak lagi ada di feed aktivitas, komentar tidak akan muncul di SUP.