Histori Revisi

Halaman ini mencantumkan perubahan dan pembaruan dokumentasi YouTube Data API (v3). Berlangganan log perubahan ini. Langganan

30 Oktober 2024

API ini kini mendukung kemampuan untuk mengidentifikasi video yang berisi konten Diubah atau Sintetis (A/S) yang realistis. Pelajari lebih lanjut kebijakan YouTube terkait konten A/S.

Contoh konten A/S mencakup video yang:

  • Membuat orang sungguhan terlihat mengatakan atau melakukan sesuatu yang sebenarnya tidak mereka katakan atau lakukan
  • Mengubah rekaman video suatu peristiwa atau tempat yang nyata
  • Menghasilkan adegan yang terlihat realistis yang sebenarnya tidak pernah terjadi

Untuk menunjukkan apakah video berisi konten A/S, tetapkan properti status.containsSyntheticMedia. Properti ini dapat ditetapkan saat memanggil metode videos.insert atau videos.update. Jika ditetapkan, properti akan ditampilkan dalam resource video.

30 April 2024

Catatan: Ini adalah pengumuman penghentian penggunaan.

Update ini berisi perubahan berikut:

API ini tidak lagi mendukung kemampuan untuk menyisipkan atau mengambil diskusi channel. Perubahan ini konsisten dengan fungsi yang didukung di situs YouTube, yang tidak mendukung postingan komentar ke channel.

13 Maret 2024

Catatan: Ini adalah pengumuman penghentian penggunaan.

Update ini berisi perubahan berikut:

Parameter sync untuk metode captions.insert dan captions.update tidak digunakan lagi. YouTube akan berhenti mendukung parameter tersebut mulai 12 April 2024.

Akibat perubahan ini, developer harus menyertakan informasi pengaturan waktu saat menyisipkan atau memperbarui trek teks atau upload akan gagal.

12 Maret 2024

Update ini berisi perubahan berikut:

Dokumentasi untuk resource captions telah diperbarui untuk menunjukkan bahwa panjang maksimum yang diizinkan untuk kolom snippet.name adalah 150 karakter. API akan menampilkan error nameTooLong jika nama jalur lebih panjang dari itu.

7 Maret 2024

Catatan: Ini adalah pengumuman penghentian penggunaan.

Properti resource channel brandingSettings.channel.moderateComments tidak digunakan lagi. YouTube akan berhenti mendukung parameter ini mulai 7 Maret 2024.

31 Januari 2024

Update ini berisi perubahan berikut:

Parameter forHandle baru dari metode channels.list memungkinkan Anda mengambil informasi tentang channel dengan menentukan nama sebutan channel YouTube-nya.

9 November 2023

Semua referensi ke resource videoId di bagian Comments telah dihapus karena resource videoId tidak ditampilkan menggunakan panggilan API.

12 September 2023

Catatan: Ini adalah pengumuman penghentian penggunaan.

Metode comments.markAsSpam tidak digunakan lagi selama beberapa tahun. Metode ini sudah tidak didukung di YouTube dan tidak lagi didukung melalui API.

Pemberitahuan penghentian penggunaan telah ditambahkan ke semua dokumen yang mereferensikan metode comments.markAsSpam.

22 Agustus 2023

Metode search.list kini mendukung parameter videoPaidProductPlacement. Parameter ini memungkinkan Anda memfilter hasil penelusuran agar hanya menyertakan video yang telah ditandai oleh kreator sebagai memiliki promosi berbayar.

18 Agustus 2023

Definisi liveStreamingDetails.concurrentViewers resource video telah diperbarui untuk mencatat bahwa jumlah penonton serentak yang ditampilkan YouTube Data API mungkin berbeda dari jumlah penonton serentak yang sudah diproses dan bebas spam yang tersedia melalui YouTube Analytics. Pusat Bantuan YouTube memberikan informasi lebih lanjut tentang metrik live streaming.

7 Agustus 2023

Seperti yang diumumkan pada 12 Juni 2023, parameter relatedToVideoId metode search.list tidak digunakan lagi. Parameter tersebut tidak lagi didukung, dan referensi ke parameter telah dihapus dari dokumentasi API.

28 Juni 2023

Metode thumbnails.set kini mendukung error uploadRateLimitExceeded, yang menunjukkan bahwa channel telah mengupload terlalu banyak thumbnail selama 24 jam terakhir dan harus mencoba lagi nanti.

12 Juni 2023

Catatan: Ini adalah pengumuman penghentian penggunaan.

Parameter relatedToVideoId metode search.list tidak digunakan lagi. YouTube akan berhenti mendukung parameter ini mulai 7 Agustus 2023.

Saat ini, pemberitahuan penghentian telah ditambahkan ke dokumentasi metode search.list. Parameter ini akan dihapus sepenuhnya dari dokumentasi search.list pada atau setelah 7 Agustus 2023.

Selain itu, contoh yang menunjukkan cara mengambil video terkait telah dihapus dari panduan penerapan API.

22 Agustus 2022

Memperbaiki anotasi jenis untuk kolom video.statistics menjadi string dari unsigned long.

5 Agustus 2022

YouTube telah mengubah cara pembuatan ID teks dan, sebagai bagian dari perubahan tersebut, menetapkan ID teks baru ke semua trek teks. Perubahan ini mungkin tidak kompatibel dengan versi sebelumnya untuk aplikasi yang menyimpan nilai caption_id, meskipun tidak akan memengaruhi aplikasi yang tidak menyimpan nilai caption_id.

Antara sekarang dan 1 Desember 2022, metode captions.list, captions.update, captions.download, dan captions.delete akan mendukung ID trek teks lama dan baru. Namun, pada atau setelah 1 Desember 2022, YouTube akan berhenti mendukung ID trek teks yang lama. Pada saat itu, memanggil salah satu metode API tersebut dengan ID trek teks lama akan menyebabkan error captionNotFound.

Untuk mempersiapkan perubahan ini, Anda harus merencanakan untuk mengganti sepenuhnya semua data trek teks yang disimpan antara sekarang dan 1 Desember 2022. Artinya, untuk video yang data trek teksnya disimpan, Anda harus menghapus data yang saat ini disimpan, lalu memanggil metode captions.list untuk mengambil kumpulan trek teks saat ini untuk video dan menyimpan data dalam respons API seperti biasa.

12 Juli 2022

Persyaratan Layanan untuk Layanan YouTube API telah diperbarui. Baca Persyaratan Layanan untuk Layanan YouTube API - Histori Revisi untuk mengetahui informasi selengkapnya.

27 April 2022

Deskripsi metode videos.insert telah diperbarui untuk mencatat bahwa ukuran file maksimum untuk video yang diupload telah ditingkatkan dari 128 GB menjadi 256 GB.

8 April 2022

Definisi parameter myRecentSubscribers dan mySubscribers metode subscriptions.list telah diperbarui untuk memperhatikan bahwa jumlah maksimum pelanggan yang ditampilkan oleh API mungkin dibatasi. Perubahan ini merupakan koreksi dokumentasi, bukan perubahan pada perilaku API.

15 Desember 2021

Seperti yang diumumkan pada 18 November 2021, sehubungan dengan perubahan untuk membuat jumlah ketidaksukaan video menjadi pribadi di seluruh platform YouTube, properti statistics.dislikeCount resource video kini bersifat pribadi.

Anda dapat mempelajari lebih lanjut perubahan ini di blog resmi YouTube.

18 November 2021

Sehubungan dengan perubahan untuk menyembunyikan jumlah tidak suka video di seluruh platform YouTube, properti statistics.dislikeCount resource video akan diubah menjadi pribadi mulai 13 Desember 2021. Artinya, properti hanya akan disertakan dalam respons API dari endpoint videos.list jika permintaan API diautentikasi oleh pemilik video.

Endpoint videos.rate tidak terpengaruh oleh perubahan ini.

Developer yang tidak menampilkan jumlah ketidaksukaan secara publik dan masih memerlukan jumlah ketidaksukaan untuk klien API mereka dapat mengajukan permohonan untuk dimasukkan ke dalam daftar yang diizinkan untuk mendapatkan pengecualian. Untuk mengajukan permohonan pengecualian, Anda harus melengkapi formulir permohonan ini.

Anda dapat mempelajari lebih lanjut perubahan ini di blog resmi YouTube.

2 Juli 2021

Catatan: Ini adalah pengumuman penghentian penggunaan.

Endpoint commentThreads.update tidak digunakan lagi dan tidak didukung lagi. Endpoint ini menduplikasi fungsi yang tersedia melalui endpoint API lainnya. Sebagai gantinya, Anda dapat memanggil comments.update

dan, jika kode Anda memerlukan resource commentThreads, lakukan panggilan sekunder ke metode commentThreads.list.

1 Juli 2021

Semua developer yang menggunakan Layanan API YouTube harus menyelesaikan Audit Kepatuhan API agar dapat diberi lebih dari alokasi kuota default sebesar 10.000 unit. Hingga saat ini, proses audit kepatuhan dan permintaan untuk alokasi unit kuota tambahan telah dilakukan oleh developer yang mengisi dan mengirimkan Layanan YouTube API - Formulir Audit dan Penambahan Kuota.

Untuk memperjelas proses ini dan lebih memenuhi kebutuhan developer yang menggunakan Layanan API, kami menambahkan tiga formulir baru dan panduan untuk melengkapi formulir tersebut:

  • Formulir Permintaan Developer yang Diaudit: Developer yang telah lulus Audit Kepatuhan API dapat mengisi dan mengirimkan formulir yang lebih singkat ini untuk meminta penambahan kuota yang dialokasikan.
  • Formulir Permohonan Banding: Developer yang project API-nya gagal dalam audit kepatuhan (atau penolakan penambahan unit kuota) dapat mengisi dan mengirimkan formulir ini.
  • Formulir Perubahan Kontrol: Developer, atau pihak mana pun yang mengoperasikan klien API atas nama developer, yang mengalami perubahan kontrol (misalnya, melalui pembelian atau penjualan saham, merger, atau bentuk transaksi perusahaan lainnya) yang terkait dengan project API harus mengisi dan mengirimkan formulir ini. Hal ini memungkinkan tim API YouTube memperbarui data kami, mengaudit kepatuhan kasus penggunaan project API baru, dan memvalidasi alokasi kuota developer saat ini.

Setiap formulir baru akan memberi tahu kami tentang tujuan penggunaan API YouTube sehingga kami dapat membantu Anda dengan lebih baik.

Detail selengkapnya tersedia di panduan Audit Kepatuhan API yang baru.

12 Mei 2021

Catatan: Ini adalah pengumuman penghentian penggunaan.

Update ini mencakup perubahan API berikut:

  • Properti contentDetails.relatedPlaylists.favorites resource channel tidak digunakan lagi. Fungsi video favorit telah dihentikan selama beberapa tahun seperti yang tercantum dalam entri histori revisi 28 April 2016.

    Sebelum pembaruan ini, API masih akan membuat playlist baru jika klien API mencoba menambahkan video ke playlist favorit yang tidak ada. Ke depannya, playlist tidak akan dibuat dalam kasus ini dan API akan menampilkan error. Upaya untuk mengubah playlist favorit dengan menambahkan, mengubah, atau menghapus item juga tidak digunakan lagi sesuai dengan pengumuman sebelumnya dan dapat mulai menampilkan error kapan saja.

  • Properti resource channel berikut tidak digunakan lagi. Properti ini sudah tidak didukung di UI YouTube Studio dan di YouTube. Akibatnya, fitur tersebut juga tidak lagi didukung melalui API.

    • brandingSettings.channel.defaultTab
    • brandingSettings.channel.featuredChannelsTitle
    • brandingSettings.channel.featuredChannelsUrls[]
    • brandingSettings.channel.profileColor
    • brandingSettings.channel.showBrowseView
    • brandingSettings.channel.showRelatedChannels

    Semua properti telah dihapus dari representasi resource channel, dan definisinya telah dihapus dari daftar properti resource. Selain itu, error yang terkait dengan properti ini telah dihapus dari dokumentasi khusus metode.

  • Properti resource channelSection berikut tidak digunakan lagi. Properti ini sudah tidak didukung di UI YouTube Studio dan di YouTube. Akibatnya, video tersebut juga tidak lagi didukung melalui API.

    • snippet.style
    • snippet.defaultLanguage
    • snippet.localized.title
    • localizations
    • localizations.(key)
    • localizations.(key).title
    • targeting
    • targeting.languages[]
    • targeting.regions[]
    • targeting.countries[]

    Sehubungan dengan perubahan ini, parameter hl metode channelSection.list juga tidak digunakan lagi karena fitur yang didukungnya tidak didukung.

    Semua properti telah dihapus dari representasi resource channelSection, dan definisinya telah dihapus dari daftar properti resource. Selain itu, error yang terkait dengan properti ini telah dihapus dari dokumentasi khusus metode.

  • Untuk properti snippet.type resource channelSection, nilai berikut tidak digunakan lagi. Nilai ini sudah tidak didukung di halaman channel YouTube dan, sebagai hasilnya, nilai ini juga tidak lagi didukung melalui API.

    • likedPlaylists
    • likes
    • postedPlaylists
    • postedVideos
    • recentActivity
    • recentPosts

  • Properti snippet.tags[] resource playlist tidak digunakan lagi. Properti ini sudah tidak didukung di YouTube dan, akibatnya, tidak lagi didukung melalui API.

9 Februari 2021

Resource playlistItem mendukung dua properti baru:

28 Januari 2021

Update ini berisi perubahan berikut:

  • Metode playlistItems.delete, playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list, dan playlists.update semuanya mendukung error playlistOperationUnsupported baru. Error ini terjadi saat permintaan mencoba melakukan operasi yang tidak diizinkan untuk playlist tertentu. Misalnya, pengguna tidak dapat menghapus video dari playlist video yang ia upload atau menghapus playlist itu sendiri.

    Dalam semua kasus, error ini menampilkan kode respons HTTP 400 (Permintaan Buruk).

  • Error watchHistoryNotAccessible dan watchLaterNotAccessible metode playlistItems.list telah dihapus dari dokumentasi. Meskipun histori tontonan dan daftar tonton nanti pengguna memang tidak dapat diakses melalui API, error khusus ini tidak ditampilkan oleh API.

15 Oktober 2020

Dua bagian baru telah ditambahkan ke Kebijakan Developer:

  • Bagian III.E.4.i yang baru memberikan informasi tambahan tentang data yang dikumpulkan dan dikirim melalui pemutar sematan YouTube. Anda bertanggung jawab atas data pengguna yang Anda kirimkan kepada kami melalui pemutar tersemat YouTube sebelum pengguna berinteraksi dengan pemutar untuk menunjukkan niat pemutaran. Anda dapat membatasi data yang dibagikan ke YouTube sebelum pengguna berinteraksi dengan pemutar dengan menyetel Putar Otomatis ke false.
  • Bagian III.E.4.j yang baru berkaitan dengan pemeriksaan status konten Dibuat untuk Anak-Anak (MFK) sebelum menyematkannya di situs dan aplikasi Anda. Anda bertanggung jawab untuk mengetahui kapan video yang Anda sematkan di Klien API Anda Dibuat untuk Anak-Anak, dan memperlakukan data yang dikumpulkan dari pemutar sematan sebagaimana mestinya. Oleh karena itu, Anda harus memeriksa status konten menggunakan Layanan YouTube Data API sebelum menyematkannya ke Klien API melalui pemutar sematan YouTube.

Panduan Menemukan status MadeForKids video yang baru menjelaskan cara mencari status MFK video menggunakan Layanan YouTube Data API.

Sehubungan dengan perubahan ini, pengingat telah ditambahkan ke dokumentasi Parameter Pemutar Tersemat untuk menjelaskan bahwa jika Anda mengaktifkan Putar Otomatis, pemutaran akan terjadi tanpa interaksi pengguna dengan pemutar; pengumpulan dan pembagian data pemutaran akan terjadi saat halaman dimuat.

8 Oktober 2020

Update ini mencakup tiga perubahan kecil terkait resource channel:

  • Objek snippet.thumbnails, yang mengidentifikasi gambar thumbnail saluran, mungkin kosong untuk saluran yang baru dibuat dan mungkin memerlukan waktu hingga satu hari untuk diisi.
  • Properti statistics.videoCount mencerminkan jumlah video publik channel saja, bahkan kepada pemilik. Perilaku ini konsisten dengan jumlah yang ditampilkan di situs YouTube.
  • Kata kunci saluran, yang diidentifikasi dalam properti brandingSettings.channel.keywords, mungkin terpotong jika melebihi panjang maksimum yang diizinkan yaitu 500 karakter atau jika berisi tanda petik yang tidak di-escape ("). Perhatikan bahwa batas 500 karakter bukanlah batas per kata kunci, melainkan batas total panjang semua kata kunci. Perilaku ini sesuai dengan yang terjadi di situs YouTube.

9 September 2020

Catatan: Ini adalah pengumuman penghentian penggunaan.

Update ini mencakup perubahan API berikut. Semua perubahan akan berlaku pada atau setelah 9 September 2020, tanggal pengumuman ini. Dengan mempertimbangkan hal tersebut, developer tidak boleh lagi mengandalkan fitur API apa pun yang tercantum di bawah.

  • Resource, metode, parameter, dan properti resource API berikut tidak digunakan lagi dan akan berhenti berfungsi pada atau setelah tanggal pengumuman ini:
    • Properti resource channel berikut:
      • Properti statistics.commentCount
      • Objek brandingSettings.image dan semua properti turunannya
      • Daftar brandingSettings.hints dan semua properti turunannya
    • Parameter filter categoryId dari metode channels.list
    • Resource guideCategories dan metode guideCategories.list
  • Respons API untuk metode channels.list tidak lagi berisi properti prevPageToken jika permintaan API menetapkan parameter managedByMe ke true. Perubahan ini tidak memengaruhi properti prevPageToken untuk permintaan channels.list lainnya, dan tidak memengaruhi properti nextPageToken untuk permintaan apa pun.
  • Properti contentDetails.relatedPlaylists.watchLater dan contentDetails.relatedPlaylists.watchHistory resource channel diumumkan sebagai tidak digunakan lagi pada 11 Agustus 2016. Dukungan metode playlistItems.insert dan metode playlistItems.delete untuk playlist ini juga tidak digunakan lagi sepenuhnya, dan kedua properti tersebut telah dihapus dari dokumentasi.
  • Parameter mySubscribers metode channels.list, yang diumumkan sebagai tidak digunakan lagi pada 30 Juli 2013, telah dihapus dari dokumentasi. Gunakan metode subscriptions.list dan parameter mySubscribers-nya untuk mengambil daftar subscriber ke channel pengguna yang diautentikasi.
  • Objek invideoPromotion resource channel dan semua properti turunannya, yang diumumkan sebagai tidak digunakan lagi pada 27 November 2017, telah dihapus dari dokumentasi.

29 Juli 2020

Kami telah menyederhanakan proses penagihan kuota untuk permintaan API dengan menghapus biaya tambahan yang terkait dengan parameter part. Mulai sekarang, kami hanya akan menagih biaya dasar untuk metode yang dipanggil. Anda dapat menemukan informasi selengkapnya tentang kuota yang disederhanakan di sini.

Dampak dari perubahan ini adalah sebagian besar panggilan API akan memiliki biaya kuota yang sedikit lebih rendah, sementara beberapa panggilan API akan tetap memiliki biaya yang sama. Perubahan ini tidak menaikkan biaya panggilan API apa pun. Secara keseluruhan, kemungkinan dampaknya adalah kuota yang dialokasikan, yang dapat dilihat di Konsol Google Cloud, akan sedikit lebih besar.

Kami sangat menyarankan semua developer untuk menyelesaikan audit kepatuhan pada project mereka guna memastikan keberlanjutan akses ke Layanan YouTube API.

Entri histori revisi ini awalnya dipublikasikan pada 20 Juli 2020.

28 Juli 2020

Semua video yang diupload melalui endpoint videos.insert dari project API yang belum diverifikasi yang dibuat setelah 28 Juli 2020 akan dibatasi ke mode tampilan pribadi. Untuk mencabut pembatasan ini, setiap project harus menjalani audit guna memverifikasi kepatuhan terhadap Persyaratan Layanan.

Kreator yang menggunakan klien API yang tidak terverifikasi untuk mengupload video akan menerima email yang menjelaskan bahwa video mereka dikunci sebagai pribadi, dan bahwa mereka dapat menghindari pembatasan tersebut dengan menggunakan klien resmi atau yang diaudit.

Project API yang dibuat sebelum 28 Juli 2020 saat ini tidak terpengaruh oleh perubahan ini. Namun, sebaiknya semua developer menyelesaikan audit kepatuhan untuk project mereka guna memastikan akses berkelanjutan ke Layanan YouTube API.

21 Juli 2020

[Diperbarui pada 28 Juli 2020.] Pembaruan dokumentasi yang dirujuk dalam entri histori revisi ini dipublikasikan ulang pada 28 Juli 2020.

Kemarin, kami memublikasikan pembaruan dokumentasi terkait proses kami untuk menagih kuota. Namun, karena keadaan yang tidak terduga, perubahan kuota belum berlaku. Akibatnya, dokumentasi telah dikembalikan demi akurasi. Agar tidak bingung, entri histori revisi yang menjelaskan perubahan telah dihapus dan akan dipublikasikan ulang dalam waktu dekat.

7 Juli 2020

Catatan: Ini adalah pengumuman penghentian penggunaan.

Parameter autoLevels dan stabilize metode videos.insert kini tidak digunakan lagi, dan kedua parameter telah dihapus dari dokumentasi. Nilainya diabaikan dan tidak memengaruhi cara pemrosesan video yang baru diupload.

15 Juni 2020

Panduan baru Mematuhi Kebijakan Developer YouTube memberikan panduan dan contoh untuk membantu Anda memastikan bahwa klien API Anda mematuhi bagian tertentu dari Persyaratan dan Kebijakan (TOS) Layanan YouTube API.

Panduan ini memberikan insight tentang cara YouTube menegakkan aspek tertentu dari TOS API, tetapi tidak menggantikan dokumen yang ada. Panduan ini membahas beberapa pertanyaan paling umum yang diajukan developer selama audit kepatuhan API. Kami harap kebijakan ini menyederhanakan proses pengembangan fitur Anda dengan membantu Anda memahami cara kami menafsirkan dan menegakkan kebijakan kami.

4 Juni 2020

Catatan: Ini adalah pembaruan untuk pengumuman penghentian sebelumnya.

Fitur buletin saluran kini sepenuhnya tidak digunakan lagi. Perubahan ini awalnya diumumkan pada 17 April 2020 dan kini telah berlaku. Akibatnya, metode activities.insert tidak lagi didukung, dan metode activities.list tidak lagi menampilkan buletin saluran. Untuk mengetahui detail selengkapnya, baca Pusat Bantuan YouTube.

17 April 2020

Catatan: Ini adalah pengumuman penghentian penggunaan.

YouTube akan menghentikan fitur buletin channel. Akibatnya, metode activities.insert tidak akan digunakan lagi, dan metode activities.list akan berhenti menampilkan buletin channel. Perubahan ini akan berlaku di API pada atau setelah 18 Mei 2020. Untuk mengetahui detail selengkapnya, lihat Pusat Bantuan YouTube.

31 Maret 2020

Update ini berisi perubahan berikut:

  • Referensi dan metode baru

    • Resource member yang baru mewakili pelanggan channel untuk suatu channel YouTube. Pelanggan memberikan dukungan keuangan berulang kepada kreator dan menerima manfaat khusus. Misalnya, pelanggan dapat melakukan chat saat kreator mengaktifkan mode khusus pelanggan untuk chat.

      Resource ini menggantikan resource sponsor, yang didokumentasikan sebagai bagian dari YouTube Live Streaming API. Resource sponsor kini tidak digunakan lagi dan klien API harus memperbarui panggilan ke metode sponsors.list untuk menggunakan metode members.list.

    • Resource membershipsLevel baru mengidentifikasi tingkat harga yang dikelola oleh kreator yang memberikan otorisasi pada permintaan API. Metode membershipsLevels.list mengambil daftar semua tingkat keanggotaan kreator.

January 10, 2020

API ini kini mendukung kemampuan untuk mengidentifikasi konten yang ditujukan untuk anak-anak, yang disebut YouTube sebagai "Dibuat untuk Anak-Anak". Pelajari lebih lanjut konten yang "Dibuat untuk Anak-Anak" di Pusat Bantuan YouTube.

Referensi channel dan video mendukung dua properti baru agar kreator konten dan penonton dapat mengidentifikasi konten yang dibuat untuk anak-anak:

  • Properti selfDeclaredMadeForKids memungkinkan kreator konten menentukan apakah channel atau video dibuat untuk anak-anak.

    Untuk saluran, properti ini dapat ditetapkan saat memanggil metode channels.update. Untuk video, properti ini dapat ditetapkan saat memanggil metode videos.insert atau videos.update.

    Perhatikan bahwa properti ini hanya disertakan dalam respons API yang berisi resource channel atau video jika pemilik saluran mengizinkan permintaan API.
  • Properti madeForKids memungkinkan pengguna mengambil status "Dibuat untuk Anak-Anak" dari channel atau video. Misalnya, status mungkin ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Lihat Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut tentang cara menetapkan audiens untuk channel, video, atau siaran Anda.

Kami juga telah memperbarui Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer. Harap lihat Persyaratan Layanan Layanan YouTube API - Histori Revisi untuk mengetahui informasi selengkapnya. Perubahan pada Persyaratan Layanan dan Kebijakan Developer untuk Layanan YouTube API akan berlaku mulai 10 Januari 2020 Waktu Pasifik.

10 September 2019

Dokumentasi referensi API telah diperbarui untuk mencerminkan perubahan pada cara jumlah subscriber dilaporkan di YouTube dan, akibatnya, dalam respons API. Akibat perubahan ini, jumlah subscriber yang ditampilkan oleh Layanan YouTube Data API akan dibulatkan ke bawah menjadi tiga angka signifikan untuk jumlah subscriber yang lebih besar dari 1.000 subscriber. Perubahan ini memengaruhi properti statistics.subscriberCount resource channel.

Catatan: Perubahan ini memengaruhi nilai properti ini meskipun pengguna mengirim permintaan resmi untuk data tentang salurannya sendiri. Pemilik channel tetap dapat melihat jumlah subscriber yang sebenarnya di YouTube Studio.

Misalnya, jika sebuah channel memiliki 123.456 subscriber, properti statistics.subscriberCount akan berisi nilai 123000. Tabel di bawah menunjukkan contoh cara jumlah subscriber dibulatkan dalam respons API dan disingkat di antarmuka pengguna YouTube lainnya yang terlihat secara publik:

Contoh jumlah subscriber YouTube Data API UI YouTube yang terlihat secara publik
1,234 1230 1,23 rb
12.345 12300 12,3 RB
123.456. 123000 123 rb
1.234.567 1230000 1,23 jt
12.345.678 12300000 12,3 jt
123.456.789 123000000 123 jt

4 April 2019

Update ini berisi perubahan berikut:

  • Dokumentasi referensi API telah diperbarui untuk menjelaskan kasus penggunaan umum untuk setiap metode dengan lebih baik dan memberikan contoh kode dinamis berkualitas tinggi melalui widget API Explorer. Lihat dokumentasi metode channels.list untuk mengetahui contohnya. Sekarang ada dua elemen baru pada halaman yang menjelaskan metode API:

    • Widget API Explorer memungkinkan Anda memilih cakupan otorisasi, memasukkan parameter dan nilai properti contoh, lalu mengirim permintaan API yang sebenarnya dan melihat respons API yang sebenarnya. Widget ini juga menawarkan tampilan layar penuh yang menampilkan contoh kode lengkap, yang diperbarui secara dinamis untuk menggunakan cakupan dan nilai yang telah Anda masukkan.

    • Bagian Kasus penggunaan umum menjelaskan satu atau beberapa kasus penggunaan umum untuk metode yang dijelaskan di halaman. Misalnya, Anda dapat memanggil metode channels.list untuk mengambil data tentang saluran tertentu atau untuk mengambil data tentang saluran pengguna saat ini.

      Anda dapat menggunakan link di bagian tersebut untuk mengisi API Explorer dengan nilai contoh untuk kasus penggunaan Anda atau untuk membuka API Explorer layar penuh dengan nilai tersebut yang sudah terisi. Perubahan ini bertujuan untuk memudahkan Anda melihat contoh kode yang langsung berlaku untuk kasus penggunaan yang Anda coba terapkan di aplikasi Anda sendiri.

    Contoh kode saat ini didukung untuk Java, JavaScript, PHP, Python, dan curl.

  • Alat contoh kode juga telah diupdate dengan UI baru yang menawarkan semua fitur yang sama seperti yang dijelaskan di atas. Dengan menggunakan alat tersebut, Anda dapat mempelajari kasus penggunaan untuk berbagai metode, memuat nilai ke dalam APIs Explorer, dan membuka APIs Explorer layar penuh untuk mendapatkan contoh kode di Java, JavaScript, PHP, dan Python.

    Sehubungan dengan perubahan ini, halaman yang sebelumnya mencantumkan contoh kode yang tersedia untuk Java, JavaScript, PHP, dan Python telah dihapus.

  • Panduan memulai untuk Java, JavaScript, PHP, dan Python telah diperbarui. Panduan yang direvisi menjelaskan cara menjalankan satu contoh dengan kunci API dan contoh lain dengan client ID OAuth 2.0 menggunakan contoh kode dari API Explorer.

Perhatikan bahwa perubahan yang dijelaskan di atas menggantikan alat interaktif yang telah ditambahkan ke dokumentasi API di tahun 2017.

9 Juli 2018

Update ini berisi perubahan berikut:

  • Definisi properti snippet.thumbnails resource channel telah diperbarui untuk memperhatikan bahwa saat menampilkan thumbnail di aplikasi, kode Anda harus menggunakan URL gambar persis seperti yang ditampilkan dalam respons API. Misalnya, aplikasi Anda tidak boleh menggunakan domain http, bukan domain https, di URL yang ditampilkan dalam respons API.

    Mulai Juli 2018, URL thumbnail channel hanya akan tersedia di domain https, yang merupakan cara URL muncul dalam respons API. Setelah waktu tersebut, Anda mungkin melihat gambar yang rusak di aplikasi jika aplikasi mencoba memuat gambar YouTube dari domain http.

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    Properti recordingDetails.location.altitude resource video tidak digunakan lagi. Tidak ada jaminan bahwa video akan menampilkan nilai untuk properti ini. Demikian pula, meskipun permintaan API mencoba menetapkan nilai untuk properti tersebut, data yang masuk mungkin tidak akan disimpan.

22 Juni 2018

Panduan implementasi, sebelumnya dikenal sebagai Panduan Penerapan dan Migrasi, telah diperbarui untuk menghapus petunjuk migrasi dari API v2 ke API v3. Selain itu, petunjuk juga telah dihapus untuk fitur yang tidak digunakan lagi di API v3, seperti video favorit.

27 November 2017

Update ini berisi perubahan berikut:

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    YouTube akan menghapus dukungan untuk fitur Video Unggulan dan Situs Unggulan, yang didukung di API melalui objek invideoPromotion resource channel. Akibatnya, objek tersebut, termasuk semua properti turunannya, tidak digunakan lagi.

    Anda masih dapat mengambil dan menetapkan data invideoPromotion hingga 14 Desember 2017. Setelah tanggal tersebut:

    • Upaya untuk mengambil bagian invideoPromotion saat memanggil channels.list akan menampilkan invideoPromotion kosong atau tidak akan menampilkan data invideoPromotion sama sekali.
    • Percobaan untuk mengupdate data invideoPromotion saat memanggil channels.update akan menampilkan respons yang berhasil hingga setidaknya 27 Mei 2018, tetapi akan diperlakukan sebagai tanpa pengoperasian, yang berarti bahwa aplikasi tidak akan benar-benar melakukan update.

    Setelah 27 Mei 2018, permintaan ini mungkin menampilkan pesan error untuk menunjukkan, misalnya, bahwa invalidPromotion adalah bagian yang tidak valid.

16 November 2017

Update ini berisi perubahan berikut:

  • Alat cuplikan kode interaktif kini mendukung contoh kode Node.js. Contoh ini juga terlihat dalam dokumentasi untuk hampir semua metode API, seperti metode channels.list.

    Contoh yang dapat disesuaikan didesain untuk memberi Anda titik awal yang spesifik untuk kasus penggunaan untuk aplikasi Node.js. Fungsinya mirip dengan kode dalam panduan memulai Node.js. Namun, contoh berisi beberapa fungsi utilitas yang tidak tercantum di panduan memulai:

    • Fungsi removeEmptyParameters mengambil daftar key-value pair yang sesuai dengan parameter permintaan API dan menghapus parameter yang tidak memiliki nilai.
    • Fungsi createResource mengambil daftar pasangan nilai kunci yang sesuai dengan properti di resource API. Kemudian, properti ini mengonversi properti menjadi objek JSON yang dapat digunakan dalam operasi insert dan update. Contoh di bawah menunjukkan serangkaian nama dan nilai properti serta objek JSON yang akan dibuat oleh kode untuknya: 
      # Key-value pairs:
{'id': 'ABC123',
 'snippet.title': 'Resource title',
 'snippet.description': 'Resource description',
 'status.privacyStatus': 'private'}

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}

    Semua contoh ini dirancang untuk didownload dan dijalankan secara lokal. Untuk informasi selengkapnya, lihat prasyarat untuk menjalankan contoh kode lengkap secara lokal dalam petunjuk alat cuplikan kode.

25 Oktober 2017

Update ini berisi perubahan berikut:

  • Contoh kode Python di alat cuplikan kode interaktif telah diupdate untuk menggunakan library google-auth dan google-auth-oauthlib, bukan library oauth2client, yang kini tidak digunakan lagi.

    Selain perubahan tersebut, alat ini kini menyediakan contoh kode lengkap untuk aplikasi Python yang diinstal dan aplikasi server web Python, yang menggunakan alur otorisasi yang sedikit berbeda. Untuk melihat contoh lengkap (dan perubahan ini):

    1. Buka alat cuplikan kode interaktif atau dokumentasi untuk metode API apa pun, seperti metode channels.list.
    2. Klik tab Python di atas contoh kode.
    3. Klik tombol di atas tab untuk beralih dari melihat cuplikan ke contoh lengkap.
    4. Sekarang tab seharusnya menampilkan contoh kode lengkap yang menggunakan alur otorisasi InstalledAppFlow. Deskripsi di atas contoh menjelaskan hal ini dan juga menautkan ke contoh untuk aplikasi server web.
    5. Klik link untuk beralih ke contoh server web. Contoh tersebut menggunakan framework aplikasi web Flask dan alur otorisasi yang berbeda.

    Semua contoh ini dirancang untuk didownload dan dijalankan secara lokal. Jika Anda ingin menjalankan contoh, lihat petunjuk untuk menjalankan contoh kode lengkap secara lokal dalam petunjuk alat cuplikan kode.

29 Agustus 2017

Update ini berisi perubahan berikut:

  • Definisi parameter forContentOwner metode search.list telah diperbarui untuk mencatat bahwa jika parameter tersebut disetel ke true, parameter type harus ditetapkan ke video.
  • Definisi parameter regionCode metode search.list telah diperbarui untuk mengklarifikasi bahwa parameter tersebut membatasi hasil penelusuran untuk video yang dapat ditonton di wilayah yang ditentukan.
  • YouTube telah memperbarui logo dan ikon branding-nya. Logo baru "dikembangkan dengan YouTube" dapat didownload dari halaman pedoman branding. Logo dan ikon YouTube baru lainnya juga ditampilkan di halaman tersebut dan dapat didownload dari situs brand YouTube.

24 Juli 2017

Update ini berisi perubahan berikut:

  • Panduan memulai YouTube Data API baru tersedia untuk iOS. Panduan ini menjelaskan cara menggunakan YouTube Data API pada aplikasi iOS sederhana yang ditulis dalam Objective-C atau Swift.
  • Alat cuplikan kode interaktif untuk YouTube Data API kini menyertakan dokumentasi yang menjelaskan beberapa fitur alat:
    • Menjalankan permintaan API
    • Beralih antara cuplikan kode dan contoh kode lengkap
    • Menggunakan fungsi boilerplate
    • Memuat resource yang ada (untuk metode update)

    Catatan: Alat ini juga disematkan dalam dokumentasi referensi API untuk metode API (contoh).

1 Juni 2017

Update ini berisi perubahan berikut:

17 Mei 2017

Update ini berisi perubahan berikut:

  • Dokumentasi referensi API telah diperbarui untuk membuat cuplikan kode lebih mudah ditemukan dan interaktif. Halaman yang menjelaskan metode API, seperti channels.list atau videos.rate, kini menampilkan alat interaktif yang memungkinkan Anda melihat dan menyesuaikan cuplikan kode di Java, JavaScript, PHP, Python, Ruby, Apps Script, dan Go.

    Untuk setiap metode, alat ini menampilkan cuplikan kode untuk satu atau beberapa kasus penggunaan, dan setiap kasus penggunaan menjelaskan cara umum untuk memanggil metode tersebut. Misalnya, Anda dapat memanggil metode channels.list untuk mengambil data tentang saluran tertentu atau saluran pengguna saat ini.

    Anda juga dapat berinteraksi dengan contoh kode:

    • Ubah parameter dan nilai properti, dan cuplikan kode akan diperbarui secara dinamis untuk mencerminkan nilai yang Anda berikan.

    • Beralih antara cuplikan kode dan contoh lengkap. Cuplikan kode menunjukkan bagian dari kode yang memanggil metode API. Contoh lengkap berisi cuplikan tersebut serta kode boilerplate untuk memberikan otorisasi dan mengirim permintaan. Contoh lengkap dapat disalin dan dijalankan dari command line atau server web lokal.

    • Jalankan permintaan dengan mengklik tombol. (Untuk menjalankan permintaan, Anda harus memberi otorisasi pada alat untuk memanggil API atas nama Anda.)

    Perhatikan bahwa alat ini telah menggantikan APIs Explorer di halaman tempat fitur ini tersedia. (Setiap halaman menampilkan link sehingga Anda juga memiliki opsi untuk memuat permintaan yang sedang Anda kerjakan di API Explorer.)

  • Alat Cuplikan Kode Data API juga telah diperbarui dengan UI baru yang menawarkan semua fitur yang sama seperti yang dijelaskan di atas. Fitur baru utama yang tersedia di halaman ini adalah:

    • Dukungan untuk permintaan API yang menulis data.
    • Dukungan untuk contoh Java.
    • Kode boilerplate yang lebih fleksibel dan komprehensif untuk memberikan otorisasi kepada pengguna dan membuat permintaan API.

27 April 2017

Update ini berisi perubahan berikut:

30 Maret 2017

Update ini berisi perubahan berikut:

  • Properti topicDetails.topicCategories[] baru dari resource channel berisi daftar URL Wikipedia yang menjelaskan konten channel. URL sesuai dengan ID topik yang ditampilkan di properti topicDetails.topicIds[] resource.
  • Properti contentDetails.videoPublishedAt baru dari resource playlistItem mengidentifikasi waktu video dipublikasikan ke YouTube. Resource sudah berisi properti snippet.publishedAt, yang mengidentifikasi waktu item ditambahkan ke playlist.
  • Seperti resource channel, resource video kini menampilkan properti topicDetails.topicCategories[], yang berisi daftar URL Wikipedia yang menjelaskan konten video. Untuk resource video, URL sesuai dengan ID topik yang ditampilkan di properti topicDetails.relevantTopicIds[] resource.
  • Properti contentDetails.contentRating.mpaatRating baru resource video mengidentifikasi rating yang diberikan Motion Picture Association of America untuk cuplikan atau pratinjau film.

27 Februari 2017

Seperti yang telah diumumkan pada 11 Agustus 2016, YouTube telah mengubah daftar ID topik yang didukung menjadi daftar hasil seleksi. Daftar lengkap ID topik yang didukung disertakan di properti topicDetails untuk resource channel dan video serta di parameter topicId metode search.list.

Perhatikan bahwa ada beberapa perubahan pada daftar yang diseleksi:

  • Topik berikut telah ditambahkan sebagai subtopik dari Society:
    NamaID topik
    Bisnis/m/09s1f
    Kesehatan/m/0kt51
    Militer/m/01h6rj
    Politik/m/05qt0
    Agama/m/06bvp
  • Topik Animated cartoon, yang sebelumnya merupakan turunan dari Entertainment, telah dihapus.
  • Topik Children's music, yang sebelumnya merupakan turunan dari Music, telah dihapus.

Akibat perubahan ini, topik yang terkait dengan video kini selalu ditampilkan dalam nilai properti topicDetails.relevantTopicIds[] resource video.

29 November 2016

Update ini berisi perubahan berikut:

  • Ada tiga perubahan kecil pada daftar ID topik yang akan didukung mulai 10 Februari 2017:

    • Kategori Professional wrestling, yang sebelumnya merupakan turunan dari kategori Sports, kini menjadi turunan dari Entertainment.
    • Kategori TV shows, yang merupakan turunan dari Entertainment, adalah kategori baru.
    • Kategori Health, yang sebelumnya merupakan turunan dari Lifestyle, telah dihapus.

    Perhatikan juga bahwa ada beberapa kategori induk (Entertainment, Gaming, Lifestyle, Music, dan Sports). Setiap video yang dikaitkan dengan kategori turunan, seperti Tennis, juga akan dikaitkan dengan kategori induk (Sports).

10 November 2016

Update ini berisi perubahan berikut:

  • Seperti yang pertama kali diumumkan pada 11 Agustus 2016, penghentian Freebase dan Freebase API memerlukan beberapa perubahan terkait ID topik. ID topik mengidentifikasi topik yang terkait dengan referensi channel dan video, dan Anda juga dapat menggunakan parameter penelusuran topicId untuk menemukan channel atau video yang terkait dengan topik tertentu.

    Pada 10 Februari 2017, YouTube akan mulai menampilkan sekumpulan kecil ID topik, bukan sekumpulan ID yang lebih terperinci yang ditampilkan sejauh ini. Selain itu, perhatikan bahwa channel dan video tidak dijamin akan dikaitkan dengan topik apa pun, yang konsisten dengan perilaku API saat ini.

    Agar Anda dapat mempersiapkan Klien API untuk perubahan tersebut, definisi parameter dan properti API berikut telah diperbarui untuk mencantumkan ID topik yang akan didukung setelah waktu tersebut. Perhatikan bahwa daftar kategori sama untuk semua properti.

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    Properti berikut tidak digunakan lagi:

    • Properti topicDetails.topicIds[] resource channel. Properti ini akan didukung hingga 10 November 2017.
    • Properti topicDetails.relevantTopicIds[] resource video. Properti ini akan didukung hingga 10 November 2017.
    • Properti topicDetails.topicIds[] resource video. Properti ini tidak akan berisi nilai setelah 10 Februari 2017. (Setelah tanggal tersebut, nilai properti topicDetails.relevantTopicIds[] akan mengidentifikasi semua topik yang terkait dengan video.)

  • Karena Freebase tidak digunakan lagi, panduan Menelusuri dengan Topik Freebase telah dihapus dari dokumentasi. Panduan tersebut memberikan contoh kode untuk menunjukkan cara aplikasi bekerja dengan Freebase API.

    Selain itu, beberapa contoh kode yang terkait dengan ID topik telah dihapus dari dokumentasi metode search.list.

2 November 2016

Update ini berisi perubahan berikut:

  • Properti dan parameter baru

    • Resource video berisi beberapa properti baru:

      • Properti player.embedHtml berisi tag <iframe> yang dapat Anda gunakan untuk menyematkan pemutar yang memutar video. Properti player.embedHeight dan player.embedWidth baru mengidentifikasi dimensi pemutar tersemat. Properti ini hanya ditampilkan jika permintaan API menentukan nilai untuk setidaknya salah satu parameter maxHeight atau maxWidth. Kedua parameter baru tersebut akan dijelaskan nanti dalam entri histori revisi ini.

      • Properti hasCustomThumbnail yang baru menunjukkan apakah uploader video telah memberikan gambar thumbnail kustom untuk video tersebut atau tidak. Perhatikan bahwa properti ini hanya dapat dilihat oleh uploader video.

      • fpbRatingReasons[] baru mengidentifikasi alasan video menerima rating FPB (Afrika Selatan).

      • mcstRating yang baru mengidentifikasi rating yang diterima video di Vietnam.

    • Metode videos.list mendukung dua parameter baru, maxHeight dan maxWidth. Anda dapat menggunakan salah satu parameter atau kedua parameter saat mengambil bagian player dalam resource video.

      Secara default, tinggi <iframe> yang ditampilkan di properti player.embedHtml adalah 360 piksel. Lebarnya disesuaikan agar cocok dengan rasio aspek video, sehingga memastikan bahwa pemutar tersemat tidak memiliki kotak hitam yang membingkai video. Jadi, misalnya, jika rasio aspek video adalah 16:9, lebar pemutar adalah 640 piksel.

      Dengan parameter baru, Anda dapat menentukan bahwa kode sematan harus menggunakan tinggi dan/atau lebar yang sesuai untuk tata letak aplikasi, bukan dimensi default. Server API menskalakan dimensi pemutar sebagaimana mestinya untuk memastikan bahwa pemutar tersemat tidak memiliki garis hitam yang membingkai video. Perhatikan bahwa kedua parameter menentukan dimensi maksimum pemutar tersemat. Jadi, jika kedua parameter ditentukan, satu dimensi mungkin masih lebih kecil dari jumlah maksimum yang diizinkan untuk dimensi tersebut.

      Misalnya, video memiliki rasio aspek 16:9. Dengan demikian, tag player.embedHtml akan berisi pemutar berukuran 640x360 jika parameter maxHeight atau maxWidth tidak ditetapkan.

      • Jika parameter maxHeight disetel ke 720, dan parameter maxWidth tidak disetel, API akan menampilkan pemutar berukuran 1280x720.
      • Jika parameter maxWidth disetel ke 960, dan parameter maxHeight tidak disetel, API akan menampilkan pemutar berukuran 960x540.
      • Jika parameter maxWidth disetel ke 960, dan parameter maxHeight disetel ke 450, API akan menampilkan pemutar 800x450.

      Properti player.embedHeight dan player.embedWidth baru, yang dijelaskan di atas, mengidentifikasi dimensi pemutar.

  • Pembaruan pada metode, properti, dan parameter yang ada

    • Deskripsi aset channelSection telah diperbarui untuk menunjukkan bahwa saluran dapat membuat maksimum 10 galeri tanpa menetapkan data penargetan dan dapat membuat maksimum 100 galeri dengan data penargetan.

      Selain itu, properti targeting resource channelSection telah diperbarui untuk mencerminkan fakta bahwa opsi penargetan hanya dapat ditetapkan menggunakan API. Opsi penargetan akan dihapus jika bagian channel diubah menggunakan antarmuka pengguna di situs YouTube.

    • Definisi properti snippet.name resource i18nLanguage telah dikoreksi untuk mencerminkan bahwa nilai tersebut mewakili nama bahasa seperti yang ditulis dalam bahasa yang ditentukan oleh parameter hl metode i18nLanguage.list.

    • Properti contentDetails.note resource playlistItem telah diperbarui untuk menunjukkan bahwa panjang maksimum nilai properti adalah 280 karakter.

    • Properti contentDetails.startAt dan contentDetails.endAt resource playlistItem tidak digunakan lagi. Kolom ini diabaikan jika ditetapkan dalam permintaan playlistItems.insert atau playlistItems.update.

    • Metode playlistItems.delete dan playlistItems.update kini mendukung parameter onBehalfOfContentOwner, yang sudah didukung untuk beberapa metode lainnya. Permintaan yang menggunakan metode tersebut juga harus diotorisasi dengan token yang memberikan akses ke cakupan https://www.googleapis.com/auth/youtubepartner.

    • Parameter publishedBefore dan publishedAfter metode search.list telah diperbarui untuk menunjukkan bahwa nilai parameter bersifat inklusif. Jadi, misalnya, jika parameter publishedBefore ditetapkan, API akan menampilkan resource yang dibuat sebelum atau pada waktu yang ditentukan.

    • Properti contentDetails.contentRating.grfilmRating resource video mendukung tiga nilai tambahan: grfilmK12, grfilmK15, dan grfilmK18.

    • Deskripsi metode videos.insert telah diperbarui untuk menunjukkan bahwa ukuran file maksimum untuk video yang diupload telah meningkat dari 64 GB menjadi 128 GB.

  • Error baru dan yang diperbarui

    • API ini mendukung error baru berikut:

      Jenis error Detail error Deskripsi
      forbidden (403) homeParameterDeprecated Metode activities.list menampilkan error ini untuk menunjukkan bahwa data aktivitas halaman beranda pengguna tidak tersedia melalui API ini. Error ini dapat terjadi jika Anda menetapkan parameter home ke true dalam permintaan yang tidak sah.
      invalidValue (400) invalidContentDetails Metode playlistItems.insert menampilkan error ini untuk menunjukkan bahwa objek contentDetails dalam permintaan tidak valid. Salah satu alasan terjadinya error ini adalah kolom contentDetails.note lebih dari 280 karakter.
      forbidden (403) watchHistoryNotAccessible Metode playlistItems.list menampilkan error ini untuk menunjukkan bahwa permintaan mencoba mengambil item playlist "histori tontonan", tetapi item tersebut tidak dapat diambil menggunakan API.
      forbidden (403) watchLaterNotAccessible Metode playlistItems.list menampilkan error ini untuk menunjukkan bahwa permintaan mencoba mengambil item playlist "tonton nanti", tetapi item tersebut tidak dapat diambil menggunakan API.
      badRequest (400) uploadLimitExceeded Metode videos.insert menampilkan error ini untuk menunjukkan bahwa channel telah melampaui jumlah video yang dapat diupload.
      forbidden (403) forbiddenEmbedSetting Metode videos.update menampilkan error ini untuk menunjukkan bahwa permintaan API mencoba menetapkan setelan penyematan yang tidak valid untuk video. Perhatikan bahwa beberapa channel mungkin tidak memiliki izin untuk menawarkan pemutar tersemat untuk live stream. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya.

    • Metode playlistItems.insert tidak lagi menampilkan error jika Anda menyisipkan video duplikat ke dalam playlist. Kesalahan tersebut sebelumnya terjadi pada beberapa playlist, seperti video favorit, yang tidak mengizinkan duplikasi, tetapi tidak lagi didukung. Secara umum, playlist mengizinkan video duplikat.

  • Info terbaru lainnya

    • Entri histori revisi untuk 15 September 2016 telah diperbarui untuk mengklarifikasi bahwa, setiap kali properti contentDetails.relatedPlaylists.watchHistory dan contentDetails.relatedPlaylists.watchLater resource channel disertakan dalam respons, keduanya selalu berisi nilai HL dan WL. Selain itu, properti tersebut hanya disertakan jika pengguna yang diotorisasi mengambil data tentang saluran pengguna itu sendiri.

15 September 2016

Update ini berisi perubahan berikut:

  • Pada 11 Agustus 2016, pembaruan histori revisi membahas beberapa perubahan terkait ID topik, termasuk fakta bahwa kumpulan ID topik yang didukung akan berubah mulai 10 Februari 2017. Daftar topik yang akan didukung akan dipublikasikan paling lambat 10 November 2016.

  • Perubahan berikut sekarang berlaku. Pemberitahuan tentang perubahan ini diberikan dalam pembaruan histori revisi pada 11 Agustus 2016:

    • Jika metode activities.list dipanggil dengan parameter home ditetapkan ke true, respons API kini berisi item yang mirip dengan yang akan dilihat pengguna YouTube yang logout di halaman beranda.

      Ini adalah perubahan kecil yang dimaksudkan untuk memberikan pengalaman pengguna yang lebih baik daripada perilaku yang dijelaskan dalam pembaruan histori revisi pada 11 Agustus 2016. Update tersebut telah menyatakan bahwa permintaan yang menggunakan parameter home akan menampilkan daftar kosong.

    • Properti contentDetails.relatedPlaylists.watchHistory dan contentDetails.relatedPlaylists.watchLater resource channel masing-masing sekarang berisi nilai HL dan WL untuk semua saluran.

      Untuk memperjelas, properti ini hanya dapat dilihat oleh pengguna yang diotorisasi yang mengambil data tentang saluran pengguna tersebut. Properti ini selalu berisi nilai HL dan WL, bahkan untuk pengguna yang diotorisasi yang mengambil data tentang channel pengguna itu sendiri. Dengan demikian, ID histori tontonan dan playlist tonton nanti tidak dapat diambil melalui API.

      Selain itu, permintaan untuk mengambil detail playlist (playlists.list) atau item playlist (playlistItems.list) untuk histori tontonan channel atau playlist tonton nanti kini menampilkan daftar kosong. Perilaku ini berlaku untuk nilai baru, HL dan WL, serta untuk semua histori tontonan atau ID playlist tonton nanti yang mungkin telah disimpan oleh Klien API Anda.

  • Objek fileDetails.recordingLocation resource video dan properti turunannya tidak lagi ditampilkan. Sebelumnya, data ini (seperti objek fileDetails induk) hanya dapat diambil oleh pemilik video.

11 Agustus 2016

Update ini berisi perubahan berikut:

  • Persyaratan Layanan untuk Layanan YouTube API yang baru dipublikasikan ("Persyaratan yang Diperbarui"), yang dibahas secara mendetail di Blog Developer dan Engineering YouTube, menyediakan berbagai pembaruan pada Persyaratan Layanan saat ini. Selain Persyaratan yang Diperbarui, yang akan berlaku mulai 10 Februari 2017, pembaruan ini mencakup beberapa dokumen pendukung untuk membantu menjelaskan kebijakan yang harus diikuti developer.

    Kumpulan lengkap dokumen baru dijelaskan di histori revisi untuk Persyaratan yang Diperbarui. Selain itu, perubahan pada Persyaratan yang Diperbarui atau dokumen pendukungnya pada masa mendatang juga akan dijelaskan dalam histori revisi tersebut. Anda dapat berlangganan perubahan listingan feed RSS dalam histori revisi tersebut dari link dalam dokumen tersebut.

  • Penghentian penggunaan Freebase dan Freebase API menyebabkan beberapa perubahan terkait ID topik. ID topik digunakan dalam sumber daya dan metode API berikut:

    • Bagian topicDetails resource channel mengidentifikasi topik yang terkait dengan channel.
    • Bagian topicDetails resource video mengidentifikasi topik yang terkait dengan video.
    • Parameter topicId metode search.list memungkinkan Anda menelusuri video atau channel yang terkait dengan topik tertentu.

    Perubahan pada fitur ini adalah:

    • Mulai 10 Februari 2017, YouTube akan mulai menampilkan sekumpulan kecil ID topik, bukan sekumpulan ID yang lebih terperinci yang ditampilkan sejauh ini. Rangkaian topik yang didukung tersebut akan mengidentifikasi kategorisasi tingkat tinggi seperti Olahraga atau Bola basket, tetapi, misalnya, kategorisasi tersebut tidak akan mengidentifikasi tim atau pemain tertentu. Kami akan mengumumkan serangkaian topik yang didukung sehingga Anda memiliki waktu untuk mempersiapkan pendaftaran Anda untuk perubahan ini.

    • Semua ID topik Freebase yang telah Anda ambil dapat digunakan untuk menelusuri konten hingga 10 Februari 2017. Namun, setelah itu, Anda hanya dapat menggunakan kumpulan topik yang lebih sedikit yang diidentifikasi di item sebelumnya untuk mengambil hasil penelusuran berdasarkan topik.

    • Setelah 10 Februari 2017, jika Anda mencoba menelusuri hasil menggunakan ID topik yang tidak ada dalam kumpulan ID topik yang didukung, API akan menampilkan set hasil kosong.

  • Beberapa kolom dan parameter API tidak digunakan lagi mulai 12 September 2016:

    • Parameter home metode activities.list memungkinkan pengguna yang diotorisasi mengambil feed aktivitas yang akan ditampilkan di halaman beranda YouTube untuk pengguna tersebut. Permintaan yang menggunakan parameter ini setelah 12 September 2016 akan menampilkan daftar kosong.

    • Properti contentDetails.relatedPlaylists.watchHistory dan contentDetails.relatedPlaylists.watchLater resource channel hanya terlihat oleh pengguna yang diotorisasi yang mengambil data tentang saluran pengguna itu sendiri. Setelah 12 September 2016, contentDetails.relatedPlaylists.watchHistory akan menampilkan nilai HL dan properti contentDetails.relatedPlaylists.watchLater akan menampilkan nilai WL untuk semua saluran.

      Permintaan untuk mengambil detail playlist (playlists.list) untuk histori tontonan channel atau playlist tonton nanti akan menampilkan daftar kosong setelah 12 September 2016. Permintaan untuk mengambil item playlist (playlistItems.list) di salah satu playlist tersebut juga akan menampilkan daftar kosong setelah waktu tersebut. Hal ini berlaku untuk nilai baru, HL dan WL, serta untuk ID playlist tonton nanti atau histori tonton yang mungkin telah disimpan oleh Klien API Anda.

    • Objek fileDetails.recordingLocation resource video atau properti turunannya lagi tidak akan ditampilkan lagi setelah 12 September 2016. Data ini hanya dapat diambil oleh pemilik video karena objek fileDetails induk hanya dapat diambil oleh pemilik video.

13 Juni 2016

Update ini berisi perubahan berikut:

  • Properti contentDetails.googlePlusUserId resource channel tidak digunakan lagi. Sebelumnya, properti hanya ada jika channel dikaitkan dengan profil Google+. Setelah penghentian penggunaan, properti ini tidak akan lagi disertakan dalam resource channel apa pun.

  • Properti snippet.authorGoogleplusProfileUrl resource comment tidak digunakan lagi. Sebelumnya, properti hanya ada jika channel dikaitkan dengan profil Google+. Setelah penghentian penggunaan, properti ini tidak akan lagi disertakan dalam resource comment apa pun.

Karena tidak satu pun dari properti ini yang akan ditampilkan setelah penghentian penggunaan, kedua properti tersebut telah dihapus dari dokumentasi resource yang sesuai.

31 Mei 2016

Update ini berisi perubahan berikut:

  • Parameter myRecentSubscribers baru dari metode subscriptions.list mengambil daftar pelanggan saluran pengguna yang diautentikasi dalam urutan kronologis terbalik dari waktu berlangganan ke saluran tersebut.

    Perhatikan bahwa parameter baru ini hanya mendukung pengambilan 1.000 subscriber terbaru ke channel pengguna yang diautentikasi. Untuk mengambil daftar lengkap pelanggan, gunakan parameter mySubscribers. Parameter tersebut, yang tidak menampilkan subscriber dalam urutan tertentu, tidak membatasi jumlah subscriber yang dapat diambil.

  • Definisi properti snippet.thumbnails.(key) telah diperbarui untuk resource activity, playlistItem, playlist, search result, thumbnail, dan video untuk menunjukkan bahwa ukuran gambar thumbnail tambahan tersedia untuk beberapa video.

    • Gambar standard memiliki lebar 640 piksel dan tinggi 480 piksel.
    • Gambar maxres memiliki lebar 1.280 piksel dan tinggi 720 piksel.

  • Definisi parameter part metode channelSection.list telah diperbarui untuk menunjukkan bahwa bagian targeting dapat diambil dengan biaya unit kuota 2.

  • Metode videos.list kini menampilkan error terlarang (403) saat permintaan yang tidak diberi otorisasi dengan benar mencoba mengambil bagian fileDetails, processingDetails, atau suggestions dari resource video. Bagian tersebut hanya tersedia untuk pemilik video.

17 Mei 2016

Alat Cuplikan Kode API Data yang baru menyediakan cuplikan kode singkat untuk kasus penggunaan YouTube Data API yang umum. Cuplikan kode saat ini tersedia untuk semua metode API hanya baca di Apps Script, Go, JavaScript, PHP, Python, dan Ruby.

Untuk setiap metode, alat ini menampilkan contoh kode untuk satu atau beberapa kasus penggunaan. Misalnya, menyediakan lima cuplikan kode untuk metode search.list:

  • Membuat daftar video berdasarkan kata kunci
  • Membuat daftar video berdasarkan lokasi
  • Membuat daftar acara live
  • Menelusuri video pengguna terautentikasi
  • Mencantumkan video terkait

Untuk setiap kasus penggunaan, alat ini akan menampilkan parameter yang digunakan dalam permintaan API. Anda dapat mengubah nilai parameter, dengan demikian alat akan memperbarui cuplikan kode untuk mencerminkan nilai parameter yang Anda berikan.

Terakhir, alat ini menampilkan respons API untuk setiap permintaan. Jika Anda telah mengubah parameter permintaan, respons API didasarkan pada nilai parameter yang diberikan. Perhatikan bahwa Anda perlu memberi otorisasi pada alat untuk mengirimkan permintaan atas nama Anda agar respons API ditampilkan.

28 April 2016

Update ini berisi perubahan berikut:

  • Properti contentDetails.projection baru dari resource video menentukan format proyeksi video. Nilai properti yang valid adalah 360 dan rectangular.

  • Properti recordingDetails.location dan fileDetails.recordingLocation resource video telah diperbarui untuk menjelaskan perbedaan antara kedua properti tersebut:

    • Properti recordingDetails.location mengidentifikasi lokasi yang ingin dikaitkan oleh pemilik video dengan video tersebut. Lokasi ini dapat diedit, dapat ditelusuri di video publik, dan mungkin ditampilkan kepada pengguna untuk video publik.
    • Nilai properti fileDetails.recordingLocation tidak dapat diubah dan mewakili lokasi yang terkait dengan file video asli yang diupload. Nilai ini hanya dapat dilihat oleh pemilik video.

  • Definisi properti contentDetails.relatedPlaylists.favorites resource channel telah diperbarui untuk mencatat bahwa nilai properti mungkin berisi ID playlist yang merujuk ke playlist kosong dan tidak dapat diambil. Hal ini karena fungsi video favorit tidak digunakan lagi. Perhatikan bahwa properti ini tidak tunduk pada kebijakan penghentian API.

  • Definisi error ineligibleAccount, yang dapat ditampilkan oleh metode comments.insert, comments.update, commentThreads.insert, atau commentThreads.update, telah diperbarui untuk menunjukkan bahwa error terjadi saat akun YouTube yang digunakan untuk memberikan otorisasi pada permintaan API belum digabungkan dengan akun Google pengguna.

20 April 2016

Update ini berisi perubahan berikut:

  • Definisi parameter part metode channels.update telah diperbarui untuk memperhatikan bahwa localizations juga merupakan nilai yang valid untuk parameter tersebut.

  • Bagian Pemakaian Kuota di panduan Memulai telah diperbarui untuk ditautkan ke Konsol Google Developer, tempat Anda dapat melihat kuota dan penggunaan kuota yang sebenarnya.

16 Maret 2016

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Dokumentasi resource channelBanner telah diperbarui untuk mencatat bahwa ukuran yang direkomendasikan untuk gambar banner channel yang diupload adalah 2560x1440 piksel. Ukuran minimum (2048x1152 piksel) tidak berubah.

    • Properti snippet.customUrl baru resource channel mengidentifikasi URL kustom yang terkait dengan channel. (Tidak semua channel memiliki URL kustom.) Pusat Bantuan YouTube menjelaskan persyaratan kelayakan untuk mendapatkan URL kustom serta cara menyiapkan URL tersebut.

    • Objek brandingSettings.watch resource channel dan semua properti turunannya tidak digunakan lagi.

    • Respons API untuk permintaan search.list kini berisi properti regionCode. Properti ini mengidentifikasi kode wilayah yang digunakan untuk kueri penelusuran. Kode wilayah menginstruksikan API agar menampilkan hasil penelusuran untuk negara yang ditetapkan.

      Nilai properti adalah kode negara ISO dua huruf yang mengidentifikasi wilayah. Metode i18nRegions.list menampilkan daftar region yang didukung. Nilai defaultnya adalah US. Jika region yang tidak didukung ditentukan, YouTube mungkin masih memilih region lain, bukan nilai default, untuk menangani kueri.

    • Definisi properti snippet.label dan snippet.secondaryReasons[].label resource videoAbuseReportReason telah diperbarui untuk memperhatikan bahwa properti berisi teks label yang dilokalkan karena alasan laporan penyalahgunaan.

      Selain itu, metode videoAbuseReportReasons.list kini mendukung parameter hl, yang menentukan bahasa yang harus digunakan untuk teks label dalam respons API. Nilai parameter default-nya adalah en_US.

    • Properti contentDetails.contentRating.ecbmctRating baru di resource video mengidentifikasi rating video dari Dewan Evaluasi dan Klasifikasi Turkiye dari Kementerian Kebudayaan dan Pariwisata.

      Selain itu, properti API untuk sistem rating lainnya mendukung nilai properti baru berikut:

      • contentDetails.contentRating.fpbRating (Afrika Selatan)
        Rating: 10; property value: fpb10
      • contentDetails.contentRating.moctwRating (Taiwan)
        Rating: R-12; nilai properti: moctwR12
      • contentDetails.contentRating.moctwRating (Taiwan)
        Rating: R-15; nilai properti: moctwR15

    • Properti liveStreamingDetails.activeLiveChatId resource video berisi ID live chat aktif yang terkait dengan video. Nilai properti hanya ada jika video merupakan live streaming saat ini yang mengaktifkan live chat. Setelah siaran berakhir dan live chat selesai, properti tidak lagi ditampilkan untuk video.

    • Properti status.rejectionReason resource video mendukung nilai properti baru legal.

  • API ini mendukung error baru berikut:

    Jenis error Detail error Deskripsi
    badRequest (400) notEditable Metode channelSections.insert, channelSections.update, dan channelSections.delete menampilkan error ini untuk menunjukkan bahwa bagian saluran yang ditentukan tidak dapat dibuat, diperbarui, atau dihapus.
    badRequest (400) styleRequired Metode channelSections.insert dan channelSections.update menampilkan error ini untuk menunjukkan bahwa resource channelSection yang dikirim dalam permintaan API harus menentukan nilai untuk properti snippet.style.
    badRequest (400) typeRequired Metode channelSections.insert dan channelSections.update menampilkan error ini untuk menunjukkan bahwa resource channelSection yang dikirimkan dalam permintaan API harus menentukan nilai untuk properti snippet.type.
    badRequest (400) processingFailure Metode commentThreads.list menampilkan error ini untuk menunjukkan bahwa server API gagal memproses permintaan. Meskipun ini dapat menjadi error sementara, hal ini biasanya menunjukkan bahwa input permintaan tidak valid. Periksa struktur resource commentThread dalam isi permintaan untuk memastikan bahwa resource tersebut valid.
    forbidden (403) commentsDisabled Metode commentThreads.list menampilkan error ini untuk menunjukkan bahwa video yang diidentifikasi oleh parameter videoId telah menonaktifkan komentar.
    badRequest (400) commentTextTooLong Metode commentThreads.insert menampilkan error ini untuk menunjukkan bahwa resource comment yang disisipkan berisi terlalu banyak karakter di properti snippet.topLevelComment.snippet.textOriginal.
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist Metode playlistItems.insert menampilkan error ini untuk menandakan bahwa video yang Anda coba tambahkan ke playlist sudah ada di playlist bersambung lain. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang playlist serial.
    badRequest (400) subscriptionForbidden Metode subscriptions.insert menampilkan error ini untuk menunjukkan bahwa Anda telah mencapai jumlah maksimum langganan atau telah membuat terlalu banyak langganan terbaru. Jika demikian, Anda dapat mencoba lagi permintaan tersebut setelah beberapa jam.
    badRequest (400) invalidCategoryId Metode videos.update menampilkan error ini untuk menunjukkan bahwa properti snippet.categoryId dalam resource video yang diupload menentukan ID kategori yang tidak valid. Gunakan metode videoCategories.list untuk mengambil kategori yang didukung.
    badRequest (400) invalidDescription Metode videos.update menampilkan error ini untuk menunjukkan bahwa properti snippet.description di resource video yang diupload menetapkan nilai yang tidak valid.
    badRequest (400) invalidPublishAt Metode videos.update menampilkan error ini untuk menunjukkan bahwa properti status.publishAt di resource video yang diupload menentukan waktu publikasi terjadwal yang tidak valid.
    badRequest (400) invalidRecordingDetails Metode videos.update menampilkan error ini untuk menunjukkan bahwa objek recordingDetails dalam resource video yang diupload menentukan detail perekaman yang tidak valid.
    badRequest (400) invalidTags Metode videos.update menampilkan error ini untuk menunjukkan bahwa properti snippet.tags dalam resource video yang diupload menentukan nilai yang tidak valid.
    badRequest (400) invalidTitle Metode videos.update menampilkan error ini untuk menunjukkan bahwa properti snippet.title di aset video yang diupload menetapkan judul video yang tidak valid atau kosong.
    badRequest (400) invalidVideoMetadata Metode videos.update menampilkan error ini untuk menunjukkan bahwa metadata permintaan tidak valid. Error ini terjadi jika permintaan memperbarui bagian snippet dari resource video, tetapi tidak menetapkan nilai untuk properti snippet.title dan snippet.categoryId.

18 Desember 2015

Hukum Uni Eropa (EU) mewajibkan pengungkapan tertentu harus diberikan kepada dan izin diperoleh dari pengguna akhir di Uni Eropa. Oleh karena itu, untuk pengguna akhir di Uni Eropa, Anda harus mematuhi Kebijakan Izin Pengguna Uni Eropa. Kami telah menambahkan pemberitahuan tentang persyaratan ini di Persyaratan Layanan YouTube API.

19 November 2015

API kini mendukung kemampuan untuk menetapkan dan mengambil teks yang dilokalkan untuk properti snippet.title dan snippet.description dari resource playlist dan video, properti snippet.title dari resource channelSection, dan properti snippet.description dari resource channel.

  • Menetapkan judul dan deskripsi yang dilokalkan

    Anda dapat menetapkan nilai yang dilokalkan untuk resource saat memanggil metode insert atau update untuk resource tersebut. Untuk menetapkan nilai yang dilokalkan untuk resource, lakukan kedua hal berikut:

    • Pastikan nilai ditetapkan untuk properti snippet.defaultLanguage resource. Properti tersebut mengidentifikasi bahasa properti snippet.title dan snippet.description resource. Nilainya dapat berupa bahasa aplikasi yang didukung atau sebagian besar kode bahasa ISO 639-1:2002 lainnya. Misalnya, jika Anda mengupload video yang memiliki judul dan deskripsi dalam bahasa Inggris, Anda akan menetapkan properti snippet.defaultLanguage ke en.

      Catatan untuk memperbarui resource channel: Untuk menetapkan properti snippet.defaultLanguage untuk resource channel, Anda sebenarnya perlu memperbarui properti brandingSettings.channel.defaultLanguage.

    • Tambahkan objek localizations ke resource yang Anda perbarui. Setiap kunci objek adalah string yang mengidentifikasi bahasa aplikasi atau kode bahasa ISO 639-1:2002, dan setiap kunci dipetakan ke objek yang berisi judul (dan deskripsi) yang dilokalkan untuk resource.

      Cuplikan contoh di bawah menetapkan bahasa default resource ke bahasa Inggris. Fitur ini juga menambahkan judul dan deskripsi dalam bahasa Jerman dan Spanyol yang dilokalkan ke video:

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}

      • Penting: Ingat bahwa saat Anda memperbarui data yang dilokalkan untuk resource, permintaan API Anda harus menyertakan semua versi data yang dilokalkan yang ada. Misalnya, jika Anda mengirim permintaan berikutnya untuk menambahkan data Portugis ke video dalam contoh di atas, permintaan tersebut harus menyertakan data yang dilokalkan untuk bahasa Jerman, Spanyol, dan Portugis.

  • Mengambil nilai yang dilokalkan

    API ini mendukung dua cara untuk mengambil nilai yang dilokalkan untuk resource:

    • Tambahkan parameter hl ke permintaan channels.list, channelSections.list, playlists.list, atau videos.list Anda guna mengambil data yang dilokalkan untuk bahasa aplikasi tertentu yang didukung situs YouTube. Jika detail resource yang dilokalkan tersedia dalam bahasa tersebut, objek snippet.localized resource akan berisi nilai yang dilokalkan. Namun, jika detail yang dilokalkan tidak tersedia, objek snippet.localized akan berisi detail resource dalam bahasa default resource.

      Misalnya, permintaan videos.list mengambil data untuk video yang dijelaskan di atas dengan data Jerman dan Spanyol yang dilokalkan. Jika parameter hl ditetapkan ke de, resource akan berisi data berikut:

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    "localized": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    }
    ...
  }
}

      Namun, jika parameter hl ditetapkan ke fr, objek snippet.localized akan berisi judul dan deskripsi dalam bahasa Inggris karena bahasa Inggris adalah bahasa default untuk resource, dan detail bahasa Prancis yang dilokalkan tidak tersedia.

      Penting: Parameter hl hanya mendukung nilai yang mengidentifikasi bahasa aplikasi yang didukung situs YouTube. Untuk menentukan apakah teks yang dilokalkan tersedia untuk bahasa lain, Anda harus mengambil bagian localizations untuk resource dan memfilter untuk menentukan apakah teks yang dilokalkan ada.

      Misalnya, Anda perlu mengambil daftar lengkap pelokalan untuk menentukan apakah teks yang dilokalkan tersedia dalam bahasa Inggris Appalachia.

    • Saat mengambil resource, sertakan localizations dalam parameter value part untuk mengambil semua detail yang dilokalkan untuk resource tersebut. Jika Anda mengambil data yang dilokalkan untuk bahasa yang bukan bahasa aplikasi YouTube saat ini, Anda harus menggunakan pendekatan ini untuk mengambil semua pelokalan, lalu memfilter untuk menentukan apakah data yang dilokalkan yang diinginkan ada.

  • Error terkait nilai teks yang dilokalkan

    API ini juga mendukung error baru berikut untuk nilai teks yang dilokalkan:

    Jenis error Detail error Deskripsi
    badRequest (400) defaultLanguageNotSetError Error ini menunjukkan bahwa permintaan yang mencoba menyisipkan atau memperbarui objek localizations untuk resource gagal karena properti snippet.defaultLanguage tidak ditetapkan untuk resource tersebut. Metode channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert, dan videos.update mendukung error ini.
    badRequest (400) localizationValidationError Error ini menunjukkan bahwa salah satu nilai dalam objek localizations resource gagal divalidasi. Misalnya, error ini dapat terjadi jika objek berisi kode bahasa yang tidak valid. Metode channels.update, channelSections.insert, channelSections.update, playlists.insert, dan playlists.update mendukung error ini.

4 November 2015

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Parameter order metode search.list telah diperbarui untuk memperhatikan bahwa jika Anda mengurutkan live streaming menurut viewCount, hasil API akan diurutkan berdasarkan jumlah penonton serentak saat siaran masih berlangsung.

    • Parameter relatedToVideoId metode search.list telah diperbarui untuk menunjukkan bahwa jika parameter ditetapkan, satu-satunya parameter lain yang didukung adalah part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (yang harus ditetapkan ke video), dan fields. Perubahan ini tidak mencerminkan perubahan pada perilaku API.

    • Definisi properti snippet.publishedAt resource video telah diperbarui untuk mencatat bahwa nilai properti, yang menentukan tanggal dan waktu video dipublikasikan, mungkin berbeda dengan waktu video diupload. Misalnya, jika video diupload sebagai video pribadi dan kemudian disetel untuk publik di lain waktu, nilai properti menentukan waktu video tersebut disetel ke publik. Definisi yang diperbarui juga menjelaskan cara nilai diisi untuk video pribadi dan tidak publik.

      Perubahan ini tidak mencerminkan perubahan pada perilaku API.

    • Definisi properti status.publishAt resource video telah diperbarui untuk memperhatikan:

      • Jika menetapkan nilai properti ini saat memanggil metode videos.update, Anda juga harus menetapkan nilai properti status.privacyStatus ke private meskipun video sudah bersifat pribadi.
      • Jika permintaan tersebut menjadwalkan video untuk dipublikasikan pada waktu yang lalu, video tersebut akan segera dipublikasikan. Dengan demikian, efek menetapkan properti status.publishAt ke tanggal dan waktu sebelumnya sama dengan mengubah privacyStatus video dari private menjadi public.

    • Properti contentDetails.contentRating.cncRating resource video menentukan rating video dari Commission de classification cinematographique Prancis. Properti ini menggantikan properti contentDetails.contentRating.fmocRating, yang sekarang tidak digunakan lagi.

    • Definisi brandingSettings.channel.keywords resource channel telah diperbarui untuk mencerminkan dengan benar bahwa nilai properti berisi daftar string yang dipisahkan spasi, bukan daftar yang dipisahkan koma, seperti yang didokumentasikan sebelumnya. Update ini tidak mencerminkan perubahan pada perilaku API.

    • Dokumentasi untuk metode thumbnails.set telah diperbarui untuk menunjukkan secara akurat bahwa isi permintaan berisi gambar thumbnail yang Anda upload dan kaitkan dengan video. Isi permintaan tidak berisi resource thumbnail. Sebelumnya, dokumentasi menyatakan bahwa Anda tidak boleh memberikan isi permintaan saat memanggil metode ini. Perubahan ini tidak mencerminkan perubahan pada perilaku API.

    • Deskripsi resource activity telah diperbarui untuk mencerminkan fakta bahwa metode activities.list saat ini tidak menyertakan resource yang terkait dengan komentar video baru. snippet.type dan contentDetails.comment resource juga telah diperbarui.

  • Error baru dan yang diperbarui

    • API kini mendukung error berikut:

      Detail error
      activities.insert
      Kode Respons HTTPbadRequest (400)
      AlasaninvalidMetadata
      DeskripsiProperti kind tidak cocok dengan jenis ID yang diberikan.
      commentThreads.update
      comments.insert
      comments.update
      Kode Respons HTTPbadRequest (400)
      AlasancommentTextTooLong
      DeskripsiResource comment yang disisipkan atau diperbarui berisi terlalu banyak karakter di properti snippet.topLevelComment.snippet.textOriginal.
      playlistItems.insert
      playlistItems.update
      Kode Respons HTTPforbidden (403)
      AlasanplaylistItemsNotAccessible
      DeskripsiPermintaan tidak diizinkan dengan benar untuk menyisipkan, memperbarui, atau menghapus item playlist yang ditentukan.
      playlists.delete
      playlists.insert
      playlists.update
      Kode Respons HTTPbadRequest (400)
      AlasanplaylistForbidden
      DeskripsiOperasi ini dilarang atau permintaan tidak diotorisasi dengan benar.
      search.list
      Kode Respons HTTPbadRequest (400)
      AlasaninvalidLocation
      DeskripsiNilai parameter location dan/atau locationRadius tidak diformat dengan benar.
      search.list
      Kode Respons HTTPbadRequest (400)
      AlasaninvalidRelevanceLanguage
      DeskripsiNilai parameter relevanceLanguage tidak diformat dengan benar.
      subscriptions.insert
      Kode Respons HTTPbadRequest (400)
      AlasansubscriptionForbidden
      DeskripsiError ini terjadi jika salah satu hal berikut benar:
      • Langganan yang Anda coba buat sudah ada
      • Anda telah mencapai jumlah maksimum langganan
      • Anda mencoba subscribe ke channel Anda sendiri, dan itu tidak didukung.
      • Anda baru-baru ini membuat terlalu banyak langganan dan perlu menunggu beberapa jam sebelum mencoba lagi permintaan tersebut.
      videos.update
      Kode Respons HTTPbadRequest (400)
      AlasaninvalidDefaultBroadcastPrivacySetting
      DeskripsiPermintaan tersebut mencoba menetapkan setelan privasi yang tidak valid untuk siaran default.

28 Agustus 2015

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Properti statistics.favoriteCount resource video tidak digunakan lagi.

      Sesuai dengan kebijakan penghentian penggunaan kami, properti ini akan terus disertakan dalam resource video setidaknya selama satu tahun setelah pengumuman ini. Namun, nilai properti kini selalu ditetapkan ke 0.

7 Agustus 2015

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Definisi properti snippet.tags[] resource video telah diperbarui untuk memberikan informasi selengkapnya tentang cara server API menghitung panjang nilai properti. Perhatikan bahwa update ini tidak mencerminkan perubahan pada perilaku API.

      Secara khusus, definisi kini menjelaskan bahwa jika tag berisi spasi, server API akan menangani nilai tag seolah-olah diapit tanda kutip, dan tanda kutip akan mengurangi batas karakter. Jadi, untuk tujuan batas karakter, tag Foo-Baz berisi tujuh karakter, tetapi tag Foo Baz berisi sembilan karakter.

    • Metode commentThreads.insert tidak lagi mendukung parameter shareOnGooglePlus, yang sebelumnya menunjukkan apakah komentar dan balasan untuk komentar tersebut juga harus diposting ke profil Google+ penulis. Jika permintaan mengirimkan parameter, server API akan mengabaikan parameter tersebut, tetapi sebaliknya akan menangani permintaan.

18 Juni 2015

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Parameter order baru dari metode commentThreads.list menentukan urutan respons API harus mencantumkan thread komentar. Rangkaian pesan dapat diurutkan menurut waktu atau relevansi. Perilaku defaultnya adalah mengurutkannya berdasarkan waktu.

    • Properti snippet.defaultAudioLanguage baru dari resource video menentukan bahasa yang digunakan dalam trek audio default video.

    • Definisi properti contentDetails.licensedContent dari resource video telah diperbarui untuk mengklarifikasi bahwa konten tersebut harus awalnya diupload ke channel yang ditautkan ke partner konten YouTube, lalu diklaim oleh partner tersebut. Hal ini tidak menunjukkan perubahan pada perilaku API yang sebenarnya.

    • Metode captions.delete, captions.download, captions.insert, captions.list, dan captions.update kini mendukung parameter onBehalfOfContentOwner, yang sudah didukung untuk beberapa metode lainnya. Permintaan yang menggunakan metode tersebut juga harus diotorisasi dengan token yang memberikan akses ke cakupan https://www.googleapis.com/auth/youtubepartner.

  • Error baru dan yang diperbarui

    • API kini mendukung error berikut:

      Detail error
      videos.rate
      Kode Respons HTTPbadRequest (400)
      AlasanemailNotVerified
      DeskripsiPengguna harus memverifikasi alamat emailnya sebelum memberi rating pada video.
      videos.rate
      Kode Respons HTTPbadRequest (400)
      AlasanvideoPurchaseRequired
      DeskripsiVideo rental hanya dapat dinilai oleh pengguna yang menyewanya.

    • Metode subscriptions.delete dan subscriptions.insert tidak lagi mendukung error accountClosed dan accountSuspended.

27 April 2015

Update ini berisi perubahan berikut:

  • Referensi dan metode baru

    • Resource videoAbuseReportReason baru berisi informasi tentang alasan video akan ditandai karena berisi konten yang melanggar. Metode videoAbuseReportReasons.list memungkinkan Anda mengambil daftar semua alasan video mungkin ditandai.

    • Metode videos.reportAbuse yang baru menyediakan cara untuk benar-benar melaporkan video yang berisi konten yang melanggar. Isi permintaan berisi objek JSON yang menentukan video yang ditandai serta alasan video tersebut dianggap berisi konten yang melanggar. Alasan yang valid dapat diperoleh dari metode videoAbuseReportReason.list yang dijelaskan di atas.

      Panduan migrasi juga telah diperbarui dengan contoh pelaporan video yang melanggar kebijakan. Dengan perubahan ini, API v3 kini mendukung semua fitur API v2 yang dijadwalkan untuk didukung. Semua fitur ini juga dijelaskan dalam panduan migrasi.

  • Pembaruan pada resource dan metode yang ada

    • Parameter filter forDeveloper baru dari metode search.list membatasi penelusuran agar hanya mengambil video yang diupload melalui aplikasi atau situs developer. Parameter forDeveloper dapat digunakan bersama dengan parameter penelusuran opsional seperti parameter q.

      Untuk fitur ini, setiap video yang diupload akan otomatis diberi tag dengan nomor project yang dikaitkan dengan aplikasi developer di Google Developers Console.

      Saat permintaan penelusuran kemudian menetapkan parameter forDeveloper ke true, server API akan menggunakan kredensial otorisasi permintaan untuk mengidentifikasi developer. Oleh karena itu, developer dapat membatasi hasil pada video yang diupload melalui aplikasi atau situs milik developer, tetapi tidak pada video yang diupload melalui aplikasi atau situs lain.

      Fitur baru ini menawarkan fungsi yang mirip, meskipun tidak identik, dengan fungsi tag developer yang didukung API v2.

    • Properti snippet.country baru dari resource channel memungkinkan pemilik channel mengaitkan channel mereka dengan negara tertentu.

      Catatan: Untuk menetapkan properti snippet.country untuk resource channel, Anda sebenarnya harus memperbarui properti brandingSettings.channel.country.

    • API kini mendukung penargetan untuk resource channelSection. Penargetan bagian channel memberikan cara untuk membatasi visibilitas bagian konten kepada pengguna yang cocok dengan kriteria tertentu.

      API ini mengekspos tiga opsi penargetan. Pengguna harus memenuhi semua setelan penargetan agar bagian channel dapat terlihat.

    • Definisi properti contentDetails.duration resource video telah dikoreksi untuk mencerminkan bahwa nilai tersebut dapat mencerminkan jam, hari, dan sebagainya.

    • Dokumentasi untuk metode channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete, dan videos.delete telah diperbaiki untuk mencerminkan bahwa, jika berhasil, semua metode tersebut menampilkan kode respons 204 HTTP (No Content).

  • Error baru dan yang diperbarui

    • API kini mendukung error berikut:

      Jenis error Detail error Deskripsi
      badRequest (400) targetInvalidCountry Metode channelSections.insert dan channelSections.update akan menampilkan error ini jika resource channelSection yang dimasukkan berisi nilai yang tidak valid untuk properti targeting.countries[].
      badRequest (400) targetInvalidLanguage Metode channelSections.insert dan channelSections.update menampilkan error ini jika resource channelSection yang disisipkan berisi nilai yang tidak valid untuk properti targeting.languages[].
      badRequest (400) targetInvalidRegion Metode channelSections.insert dan channelSections.update menampilkan error ini jika resource channelSection yang disisipkan berisi nilai yang tidak valid untuk properti targeting.regions[].
      badRequest (400) operationNotSupported Metode comments.insert menampilkan error ini jika pengguna API tidak dapat menyisipkan komentar sebagai balasan atas komentar tingkat teratas yang diidentifikasi oleh properti snippet.parentId. Dalam resource commentThread, properti snippet.canReply menunjukkan apakah pelihat saat ini dapat membalas rangkaian pesan.
      badRequest (400) invalidChannelId Metode search.list menampilkan error ini jika parameter channelId dalam permintaan menentukan ID channel yang tidak valid.
      badRequest (400) subscriptionForbidden Metode subscriptions.insert akan menampilkan error ini jika pengguna API mencoba berlangganan ke saluran pengguna itu sendiri.

    • Metode captions.update tidak lagi mendukung error invalidMetadata dan videoNotFound.

16 April 2015

Update ini berisi perubahan berikut:

  • Panduan migrasi telah diperbarui untuk menjelaskan cara memigrasikan aplikasi yang masih menggunakan fungsi komentar dari API v2.

    Panduan ini juga menyebutkan beberapa fitur komentar yang tidak didukung oleh API v2, tetapi didukung di API v3. Ini mencakup:

    • Mengambil komentar tentang channel
    • Mengambil semua rangkaian komentar yang terkait dengan channel, yang berarti respons API dapat berisi komentar tentang channel atau videonya.
    • Memperbarui teks komentar
    • Menandai komentar sebagai spam
    • Menetapkan status moderasi komentar

  • Panduan Berlangganan notifikasi push telah diperbarui untuk mencerminkan fakta bahwa notifikasi hanya dikirim ke hub Google PubSubHubBub dan tidak juga ke hub Superfeedr seperti yang ditunjukkan sebelumnya.

9 April 2015

Update ini berisi perubahan berikut:

  • Resource commentThread dan comment baru API memungkinkan Anda mengambil, menyisipkan, memperbarui, menghapus, dan memoderasi komentar.

    • Referensi commentThread berisi informasi tentang rangkaian komentar YouTube, yang terdiri dari komentar dan balasan tingkat atas, jika ada, untuk komentar tersebut. Resource commentThread dapat merepresentasikan komentar tentang video atau channel.

      Komentar tingkat atas dan balasan sebenarnya adalah resource comment yang disusun bertingkat di dalam resource commentThread. Penting untuk diperhatikan bahwa resource commentThread tidak harus berisi semua balasan untuk sebuah komentar, dan Anda harus menggunakan metode comments.list jika ingin mengambil semua balasan untuk komentar tertentu. Selain itu, beberapa komentar tidak memiliki balasan.

      API ini mendukung metode berikut untuk resource commentThread:

      • commentThreads.list – Mengambil daftar rangkaian pesan komentar. Gunakan metode ini untuk mengambil komentar yang terkait dengan video atau channel tertentu.
      • commentThreads.insert – Membuat komentar tingkat atas baru. (Gunakan metode comments.insert untuk membalas komentar yang ada.)
      • commentThreads.update – Mengubah komentar tingkat atas.

    • Referensi comment berisi informasi tentang satu komentar YouTube. Resource comment dapat mewakili komentar tentang video atau channel. Selain itu, komentar dapat berupa komentar tingkat atas atau balasan untuk komentar tingkat atas.

      API ini mendukung metode berikut untuk resource comment:

      • comments.list – Mengambil daftar komentar. Gunakan metode ini untuk mengambil semua balasan atas komentar tertentu.
      • comments.insert – Membuat balasan untuk komentar yang ada.
      • comments.update – Mengubah komentar.
      • comments.markAsSpam – Menandai satu atau beberapa komentar sebagai spam.
      • comments.setModerationStatus – Menetapkan status moderasi satu atau beberapa komentar. Misalnya, hapus komentar untuk ditampilkan secara publik atau tolak komentar sebagai tidak layak untuk ditampilkan. Permintaan API harus diotorisasi oleh pemilik channel atau video yang terkait dengan komentar.
      • comments.delete – Menghapus komentar.

    Perhatikan bahwa cakupan https://www.googleapis.com/auth/youtube.force-ssl baru API, yang dijelaskan di histori revisi untuk 2 April 2015, diperlukan untuk panggilan ke metode comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert, dan commentThreads.update.

  • Panduan Berlangganan pemberitahuan push yang baru menjelaskan dukungan baru API untuk pemberitahuan push melalui PubSubHubBub, protokol publikasi/langganan server ke server untuk resource yang dapat diakses Web. Server callback PubSubHubBub Anda dapat menerima notifikasi feed Atom saat saluran melakukan salah satu aktivitas berikut:

    • mengupload video
    • memperbarui judul video
    • memperbarui deskripsi video

  • Panduan migrasi juga telah diperbarui untuk mencatat dukungan baru untuk notifikasi push. Namun, karena API v2 mendukung banyak jenis notifikasi push lainnya yang tidak didukung di API v3, dukungan PubSubHubBub masih tercantum di bagian Tidak digunakan lagi dalam panduan tersebut.

  • Cakupan https://www.googleapis.com/auth/youtube.force-ssl baru API sekarang menjadi cakupan yang valid untuk semua metode API yang sebelumnya mendukung cakupan https://www.googleapis.com/auth/youtube.

  • API kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    badRequest (400) invalidRating Metode videos.rate menampilkan error ini jika permintaan berisi nilai yang tidak terduga untuk parameter rating.

  • Metode subscriptions.insert tidak lagi mendukung error subscriptionLimitExceeded, yang sebelumnya menunjukkan bahwa pelanggan yang diidentifikasi dengan permintaan telah melampaui batas rasio langganan.

2 April 2015

Update ini berisi perubahan berikut:

  • Resource captions baru mewakili trek teks YouTube. Trek teks dikaitkan dengan tepat satu video YouTube.

    API ini mendukung metode untuk mencantumkan, menyisipkan, memperbarui, mendownload, dan menghapus trek teks.

  • Panduan migrasi juga telah diperbarui untuk menjelaskan cara memigrasikan aplikasi yang masih menggunakan fungsi teks di API v2.

  • Cakupan https://www.googleapis.com/auth/youtube.force-ssl baru API memerlukan komunikasi dengan server API dilakukan melalui koneksi SSL.

    Cakupan baru ini memberikan akses yang sama dengan cakupan https://www.googleapis.com/auth/youtube. Terlebih lagi, kedua cakupan tersebut secara fungsional identik karena server YouTube API hanya tersedia melalui endpoint HTTPS. Akibatnya, meskipun cakupan https://www.googleapis.com/auth/youtube tidak memerlukan koneksi SSL, sebenarnya tidak ada cara lain untuk membuat permintaan API.

    Cakupan baru diperlukan untuk panggilan ke semua metode resource caption.

11 Maret 2015

Update ini berisi perubahan berikut:

  • Panduan migrasi YouTube Data API (v3) berisi tab baru bernama Baru di API v3, yang mencantumkan berbagai fitur yang didukung API v3 dan yang tidak didukung API v2. Fitur yang sama sebelumnya dan masih tercantum di tab lain dalam panduan. Misalnya, fitur baru yang menjelaskan cara memperbarui data kampanye promosi in-video untuk channel juga tercantum di tab Channel (profil).

  • Panduan migrasi YouTube Data API (v3) telah diperbarui untuk menunjukkan bahwa API v3 akan mendukung fitur API v2 berikut:

  • Panduan migrasi YouTube Data API (v3) telah diperbarui untuk menunjukkan bahwa fitur API v2 berikut tidak akan didukung di API v3:

    • Mengambil rekomendasi video – API v3 tidak mengambil daftar yang hanya berisi video yang direkomendasikan untuk pengguna API saat ini. Namun, Anda dapat menggunakan API v3 untuk menemukan video yang direkomendasikan dengan memanggil metode activities.list dan menetapkan nilai parameter home ke true.

      Dalam respons API, resource sesuai dengan video yang direkomendasikan jika nilai properti snippet.type adalah recommendation. Dalam hal ini, properti contentDetails.recommendation.reason dan contentDetails.recommendation.seedResourceId akan berisi informasi tentang alasan video direkomendasikan. Perlu diketahui bahwa tidak ada jaminan bahwa respons akan berisi jumlah video yang direkomendasikan tertentu.

    • Mengambil saran channel

    • Mengambil video langganan baru – API v3 tidak mengambil daftar yang hanya berisi video yang baru-baru ini diupload ke channel yang di-subscribe pengguna API. Namun, Anda dapat menggunakan API v3 untuk menemukan video langganan baru dengan memanggil metode activities.list dan menetapkan nilai parameter home ke true.

      Dalam respons API, resource sesuai dengan video langganan baru jika nilai properti snippet.type adalah upload. Perlu diperhatikan bahwa tidak ada jaminan bahwa respons akan berisi sejumlah video langganan baru.

    • Dukungan feed RSS

    • Notifikasi push untuk pembaruan feed – Notifikasi push yang mendukung API v2, menggunakan Simple Update Protocol (SUP) atau PubSubHubbub, untuk memantau feed aktivitas pengguna untuk pengguna YouTube. Notifikasi diberikan untuk subscription channel baru dan kapan video dinilai, dibagikan, ditandai sebagai favorit, dikomentari, atau diupload.

      API v3 akan mendukung notifikasi push menggunakan protokol PubSubHubbub, tetapi notifikasi hanya akan mencakup upload dan update video pada judul atau deskripsi video.

    • Lokasi channel – API v2 menggunakan tag <yt:location> untuk mengidentifikasi lokasi pengguna seperti yang dimasukkan di profil publik YouTube channel. Meskipun beberapa developer menggunakan kolom ini untuk mengaitkan channel dengan negara tertentu, data kolom tersebut tidak dapat digunakan secara konsisten untuk tujuan tersebut.

    • Menyetel atau mengambil tag developer – API v2 mendukung kemampuan untuk mengaitkan kata kunci, atau tag developer, dengan video pada saat video diupload. Tag developer tidak akan ditampilkan kepada pengguna YouTube, tetapi pemilik video dapat mengambil video yang cocok dengan tag developer tertentu.

      API v3 akan menyediakan fitur yang serupa, tetapi tidak sama. Secara khusus, developer akan dapat menelusuri video yang diupload oleh aplikasi developer sendiri. Untuk fitur ini, setiap video yang diupload akan otomatis diberi tag dengan nomor project yang dikaitkan dengan aplikasi developer di Google Developers Console. Kemudian, developer menggunakan nomor project yang sama untuk menelusuri video.

    • Daftar video menurut tanggal publikasi, jumlah penayangan, atau rating – Di API v2, parameter orderby memungkinkan Anda mengurutkan video dalam playlist menurut posisi, durasi, tanggal publikasi, judul, dan beberapa nilai lainnya. Di API v3, item playlist biasanya diurutkan berdasarkan posisi dalam urutan menaik dan opsi pengurutan lainnya tidak tersedia.

      Ada beberapa pengecualian. Upload baru, video favorit, video yang disukai, atau video yang baru ditonton akan otomatis ditambahkan sebagai item pertama (snippet.position=0) untuk jenis playlist berikut. Jadi, setiap daftar ini diurutkan secara efektif dalam urutan dari item terbaru hingga terlama berdasarkan waktu saat item tersebut ditambahkan ke daftar.

      • upload pengguna
      • video favorit
      • video yang disukai
      • riwayat tontonan

      Namun, perlu diperhatikan bahwa item baru yang ditambahkan ke playlist "Tonton nanti" ditambahkan sebagai item terakhir dalam daftar tersebut, sehingga daftar tersebut diurutkan secara efektif dari item terlama ke item terbaru.

    • Batch processing – API v3 mendukung salah satu kasus penggunaan batch processing yang didukung oleh API v2. Metode channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list, dan videos.list API v3 semuanya mendukung parameter id, yang dapat digunakan untuk menentukan daftar ID yang dipisahkan koma (ID video, ID channel, dll.). Dengan menggunakan metode tersebut, Anda dapat mengambil daftar beberapa resource dengan satu permintaan.

    Dengan perubahan ini, panduan ini sekarang mengidentifikasi semua fungsi yang didukung di API (v2) lama yang tidak akan digunakan lagi di versi API saat ini (v3).

4 Maret 2015

Update ini berisi perubahan berikut:

  • Metode channelSections.delete dan channelSections.update kini mendukung parameter onBehalfOfContentOwner, yang sudah didukung untuk beberapa metode lainnya.

  • Properti berikut dan properti turunannya tidak digunakan lagi:

    • brandingSettings.image.backgroundImageUrl
    • brandingSettings.image.largeBrandedBannerImageImapScript
    • brandingSettings.image.largeBrandedBannerImageUrl
    • brandingSettings.image.smallBrandedBannerImageImapScript
    • brandingSettings.image.smallBrandedBannerImageUrl

    Catatan: Tidak satu pun dari properti ini yang tunduk pada Kebijakan Penghentian Penggunaan API.

  • Properti contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons baru dari resource video mengidentifikasi alasan yang menjelaskan mengapa video menerima rating DJCQT (Brasil).

  • API kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    notFound (404) channelNotFound Metode channels.update menampilkan error ini jika parameter id permintaan menentukan saluran yang tidak dapat ditemukan.
    badRequest (400) manualSortRequiredinvalidValue Metode playlistItems.insert dan playlistItems.update menampilkan error ini jika permintaan mencoba menetapkan posisi item playlist, tetapi playlist tidak menggunakan pengurutan manual. Misalnya, item playlist dapat diurutkan menurut tanggal atau popularitas. Anda dapat mengatasi error ini dengan menghapus elemen snippet.position dari resource yang dikirim dalam isi permintaan. Jika ingin item playlist memiliki posisi tertentu dalam daftar, Anda harus memperbarui setelan pengurutan playlist terlebih dahulu ke Manual. Setelan ini dapat disesuaikan di Pengelola Video YouTube.
    forbidden (403) channelClosed Metode playlists.list menampilkan error ini jika parameter channelId permintaan menentukan saluran yang telah ditutup.
    forbidden (403) channelSuspended Metode playlists.list menampilkan error ini jika parameter channelId permintaan menentukan channel yang telah ditangguhkan.
    forbidden (403) playlistForbidden Metode playlists.list akan menampilkan error ini jika parameter id permintaan tidak mendukung permintaan atau permintaan tidak diberi otorisasi dengan benar.
    notFound (404) channelNotFound Metode playlists.list akan menampilkan error ini jika parameter channelId permintaan menentukan saluran yang tidak dapat ditemukan.
    notFound (404) playlistNotFound Metode playlists.list akan menampilkan error ini jika parameter id permintaan menentukan playlist yang tidak dapat ditemukan.
    notFound (404) videoNotFound Metode videos.list menampilkan error ini jika parameter id permintaan menentukan video yang tidak dapat ditemukan.
    badRequest (400) invalidRating Metode videos.rate menampilkan error ini jika permintaan berisi nilai yang tidak terduga untuk parameter rating.

2 Maret 2015

Update ini berisi perubahan berikut:

  • Metode search.list kini mendukung parameter relevanceLanguage, yang memungkinkan Anda meminta hasil yang paling relevan untuk bahasa tertentu.

    Panduan migrasi YouTube Data API (v3) juga telah diperbarui untuk menjelaskan cara menggunakan parameter baru ini. Parameter ini mengatasi kesenjangan fitur yang sebelumnya ada antara versi API saat ini (v3) dan versi sebelumnya (v2), yang sudah tidak digunakan lagi.

  • Panduan migrasi YouTube Data API (v3) juga telah diperbarui untuk menunjukkan penghentian kolom metadata dan feed khusus yang disediakan API v2 untuk mendeskripsikan film, cuplikan, acara televisi, season televisi, dan episode televisi.

14 Januari 2015

Update ini berisi perubahan berikut:

  • Panduan migrasi YouTube Data API (v3) telah diperbarui untuk menjelaskan cara menggunakan API v3 untuk mengupload video menggunakan JavaScript. (Lihat bagian Mengupload video untuk mengetahui detailnya.) Fungsi ini sebanding dengan fungsi upload berbasis browser yang didukung API v2. Perhatikan bahwa perubahan pada panduan migrasi ini tidak mencerminkan perubahan API yang sebenarnya, tetapi ketersediaan kode contoh baru untuk mengupload video dengan JavaScript sisi klien.

    Mengingat dukungan untuk mengupload video dengan library klien JavaScript dan CORS, panduan migrasi tidak lagi mencantumkan upload berbasis browser sebagai fitur yang mungkin tidak digunakan lagi di API v3.

  • Dokumentasi untuk metode videos.insert telah diperbarui untuk menyertakan contoh kode JavaScript baru yang dijelaskan di atas. Daftar contoh kode JavaScript untuk YouTube Data API (v3) juga telah diperbarui.

11 November 2014

Update ini berisi perubahan berikut:

  • Biaya kuota untuk panggilan ke metode search.list telah diubah menjadi 100 unit.

    Penting: Dalam banyak kasus, Anda dapat menggunakan metode API lain untuk mengambil informasi dengan biaya kuota yang lebih rendah. Misalnya, pertimbangkan dua cara berikut untuk menemukan video yang diupload ke channel GoogleDevelopers.

    • Biaya kuota: 100 unit

      Panggil metode search.list dan telusuri GoogleDevelopers.

    • Biaya kuota: 6 unit

      Panggil metode channels.list untuk menemukan ID saluran yang tepat. Tetapkan parameter forUsername ke GoogleDevelopers dan parameter part ke contentDetails. Dalam respons API, properti contentDetails.relatedPlaylists.uploads menentukan ID playlist untuk video yang diupload channel.

      Kemudian, panggil metode playlistItems.list dan tetapkan parameter playlistId ke ID yang diambil dan parameter part ke snippet.

8 Oktober 2014

Update ini berisi perubahan berikut:

  • Resource channel berisi dua properti baru:

    • Properti status.longUploadsStatus menunjukkan apakah channel memenuhi syarat untuk mengupload video yang berdurasi lebih dari 15 menit. Properti ini hanya ditampilkan jika pemilik channel mengizinkan permintaan API. Nilai properti yang valid adalah:

      • allowed – Channel dapat mengupload video berdurasi lebih dari 15 menit.
      • eligible – Channel memenuhi syarat untuk mengupload video berdurasi lebih dari 15 menit, tetapi harus mengaktifkan fitur ini terlebih dahulu.
      • disallowed – Channel tidak dapat atau tidak memenuhi syarat untuk mengupload video yang berdurasi lebih dari 15 menit.

      Lihat definisi properti untuk informasi selengkapnya tentang nilai ini. Pusat Bantuan YouTube juga memberikan informasi yang lebih mendetail tentang fitur ini.

    • Properti invideoPromotion.useSmartTiming menunjukkan apakah kampanye promosi saluran menggunakan "smart timing" atau tidak. Fitur ini mencoba menampilkan promosi pada titik tertentu dalam video yang cenderung diklik dan cenderung tidak mengganggu pengalaman menonton. Fitur ini juga mengambil satu promosi untuk ditampilkan di setiap video.

  • Definisi properti snippet.title dan snippet.categoryId resource video telah diperbarui untuk memperjelas cara API menangani panggilan ke metode videos.update. Jika Anda memanggil metode tersebut untuk memperbarui bagian snippet dari resource video, Anda harus menetapkan nilai untuk kedua properti tersebut.

    Jika Anda mencoba memperbarui bagian snippet dari resource video dan tidak menetapkan nilai untuk kedua properti tersebut, API akan menampilkan error invalidRequest. Deskripsi error tersebut juga telah diperbarui.

  • Properti contentDetails.contentRating.oflcRating resource video, yang mengidentifikasi rating video dari Office of Film and Literature Classification di Selandia Baru, kini mendukung dua rating baru: oflcRp13 dan oflcRp16. Keduanya masing-masing sesuai dengan rating RP13 dan RP16.

  • Metode channelBanners.insert kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    badRequest bannerAlbumFull Album Header Channel YouTube milik pemilik channel memiliki terlalu banyak gambar. Pemilik channel harus membuka http://photos.google.com, membuka halaman album, dan menghapus beberapa gambar dari album tersebut.

12 September 2014

Update ini berisi perubahan berikut:

  • Biaya kuota untuk panggilan ke metode search.list telah berubah dari 1 unit menjadi 2 unit selain biaya bagian resource yang telah ditetapkan.

13 Agustus 2014

Update ini berisi perubahan berikut:

  • Metode subscriptions.insert kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    badRequest subscriptionLimitExceeded Pelanggan yang diidentifikasi dengan permintaan tersebut telah melampaui batas jumlah langganan. Langganan lainnya dapat dicoba dalam beberapa jam.

12 Agustus 2014

Update ini berisi perubahan berikut:

  • Panduan baru, berjudul Memigrasikan Aplikasi Anda ke YouTube Data API (v3), menjelaskan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi yang tersedia di YouTube Data API (v2). API lama secara resmi tidak digunakan lagi mulai 4 Maret 2014. Panduan ini bertujuan untuk membantu Anda memigrasikan aplikasi yang masih menggunakan API v2 ke versi API terbaru.

8 Juli 2014

Update ini berisi perubahan berikut:

  • Metode playlists.insert kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    badRequest maxPlaylistExceeded Error ini terjadi jika playlist tidak dapat dibuat karena saluran sudah memiliki jumlah maksimum playlist yang diizinkan.

18 Juni 2014

Update ini berisi perubahan berikut:

  • Deskripsi setiap metode API telah diperbarui untuk menyertakan biaya kuota yang dikeluarkan oleh panggilan ke metode tersebut. Demikian pula, definisi parameter part telah diperbarui untuk menentukan biaya kuota setiap bagian yang dapat diambil dalam panggilan API. Misalnya, panggilan ke metode subscriptions.insert memiliki biaya kuota sekitar 50 unit. Resource subscription juga berisi tiga bagian (snippet, contentDetails, dan subscriberSnippet), dan masing-masing memiliki biaya dua unit.

    Perlu diingat bahwa biaya kuota dapat berubah tanpa pemberitahuan.

  • Referensi video kini mendukung 43 sistem rating konten baru, yang mengidentifikasi rating yang diterima video dari berbagai lembaga rating nasional.

28 Mei 2014

Update ini berisi perubahan berikut:

  • Metode search.list kini mendukung parameter location dan locationRadius, yang memungkinkan Anda menelusuri video yang terkait dengan lokasi geografis. Permintaan harus menentukan nilai untuk kedua parameter guna mengambil hasil berdasarkan lokasi, dan API akan menampilkan error jika permintaan hanya menyertakan salah satu dari dua parameter.

    • Parameter location menentukan koordinat lintang/bujur di pusat area geografis melingkar.

    • Parameter locationRadius menentukan jarak maksimum lokasi yang terkait dengan video dari pusat area agar video tetap disertakan dalam hasil penelusuran.

13 Mei 2014

Update ini berisi perubahan berikut:

  • Properti invideoPromotion.items[] resource channel telah diperbarui untuk menunjukkan bahwa biasanya Anda hanya dapat menetapkan satu item yang dipromosikan untuk channel Anda. Jika Anda mencoba menyisipkan terlalu banyak item yang dipromosikan, API akan menampilkan error tooManyPromotedItems, yang memiliki kode status HTTP 400.

  • Resource channelSection kini dapat berisi informasi tentang beberapa jenis konten unggulan baru. Properti snippet.type resource channelSection kini mendukung nilai berikut:

    • postedPlaylists - playlist yang diposting pemilik channel ke feed aktivitas channel
    • postedVideos - video yang diposting pemilik channel ke feed aktivitas channel
    • subscriptions - channel yang di-subscribe pemilik channel

  • Properti contentDetails.contentRating.ifcoRating baru dari resource video mengidentifikasi rating yang diterima video dari Irish Film Classification Office.

  • Definisi properti position.cornerPosition resource watermark telah diperbarui untuk memperhatikan bahwa watermark selalu muncul di sudut kanan atas pemutar video.

  • Definisi parameter q untuk metode search.list telah diperbarui untuk menunjukkan bahwa istilah kueri dapat menggunakan operator Boolean NOT (-) untuk mengecualikan video yang terkait dengan istilah penelusuran tertentu. Nilai ini juga dapat menggunakan operator Boolean OR (|) untuk menemukan video yang terkait dengan salah satu dari beberapa istilah penelusuran.

  • Definisi properti pageInfo.totalResults yang ditampilkan dalam respons API untuk panggilan search.list telah diperbarui untuk menunjukkan bahwa nilai tersebut adalah perkiraan dan mungkin tidak mewakili nilai yang tepat. Selain itu, nilai maksimumnya adalah 1.000.000. Anda tidak boleh menggunakan nilai ini untuk membuat link penomoran halaman. Sebagai gantinya, gunakan nilai properti nextPageToken dan prevPageToken untuk menentukan apakah akan menampilkan link penomoran halaman.

  • Metode watermarks.set dan watermarks.unset telah diperbarui untuk menunjukkan bahwa API menampilkan kode respons 204 HTTP untuk permintaan yang berhasil ke metode tersebut.

2 Mei 2014

Update ini berisi perubahan berikut:

  • Resource i18nLanguage baru mengidentifikasi bahasa aplikasi yang didukung situs YouTube. Bahasa aplikasi juga dapat disebut sebagai bahasa UI. Untuk situs web YouTube, bahasa aplikasi dapat dipilih secara otomatis berdasarkan setelan Akun Google, bahasa browser, atau lokasi IP, dan pengguna juga dapat memilih secara manual bahasa UI yang diinginkan dari footer situs YouTube.

    API mendukung metode untuk mencantumkan bahasa aplikasi yang didukung. Bahasa yang didukung dapat digunakan sebagai nilai parameter hl saat memanggil metode API seperti videoCategories.list dan guideCategories.list.

  • Resource i18nRegion baru mengidentifikasi area geografis yang dapat dipilih pengguna YouTube sebagai wilayah konten pilihan. Wilayah konten juga dapat disebut sebagai lokalitas konten. Untuk situs YouTube, region konten dapat dipilih secara otomatis berdasarkan heuristik seperti domain YouTube atau lokasi IP pengguna, dan pengguna juga dapat memilih secara manual wilayah konten yang diinginkan dari footer situs YouTube.

    API ini mendukung metode untuk mencantumkan wilayah konten yang didukung. Kode region yang didukung dapat digunakan sebagai nilai parameter regionCode saat memanggil metode API seperti search.list, videos.list, activities.list, dan videoCategories.list.

7 April 2014

Update ini berisi perubahan berikut:

  • Resource channelSection baru berisi informasi tentang sekumpulan video yang dipilih channel untuk ditampilkan. Misalnya, suatu bagian dapat menampilkan upload terbaru channel, upload paling populer, atau video dari satu atau beberapa playlist.

    API ini mendukung metode untuk mencantumkan, menyisipkan, memperbarui, atau menghapus bagian channel. Anda dapat mengambil daftar bagian channel untuk channel pengguna yang diautentikasi, dengan menentukan ID channel tertentu, atau dengan menentukan daftar ID bagian channel yang unik.

    Dokumentasi error juga telah diperbarui untuk menjelaskan pesan error yang didukung API secara khusus untuk metode baru ini.

  • Definisi objek fileDetails resource video telah diperbarui untuk menjelaskan bahwa objek tersebut hanya akan ditampilkan jika properti processingDetails.fileDetailsAvailability video memiliki nilai available.

    Demikian pula, definisi objek suggestions resource video telah diperbarui untuk menjelaskan bahwa objek tersebut hanya akan ditampilkan jika properti processingDetails.tagSuggestionsAvailability video atau properti processingDetails.editorSuggestionsAvailability-nya memiliki nilai available.

  • Dokumentasi untuk metode videos.insert dan videos.update telah diperbarui untuk mencerminkan bahwa properti status.publishAt dapat ditetapkan saat memanggil metode tersebut.

  • Definisi objek invideoPromotion resource channel telah diperbarui untuk menjelaskan bahwa objek hanya dapat diambil oleh pemilik channel.

  • Daftar parameter untuk metode videos.rate telah diperbarui untuk mencerminkan bahwa metode tersebut tidak benar-benar mendukung parameter onBehalfOfContentOwner. Ini adalah error dokumentasi karena permintaan videos.rate yang menetapkan parameter ini menampilkan error 500.

31 Maret 2014

Update ini berisi perubahan berikut:

13 Maret 2014

Update ini berisi perubahan berikut:

  • API kini mendukung bagian contentOwnerDetails untuk resource channel. Bagian baru ini berisi data channel yang relevan untuk partner YouTube yang ditautkan dengan channel, termasuk ID pemilik konten yang ditautkan ke channel dan tanggal serta waktu saat pemilik konten dan channel ditautkan. Perhatikan bahwa bagian baru ini tidak tunduk pada kebijakan penghentian penggunaan.

  • Dokumentasi sekarang mencantumkan panjang karakter maksimum yang didukung untuk properti berikut:

    Resource Properti Panjang maksimum
    channel invideoPromotion.items[].customMessage 40 karakter
    video snippet.title 100 karakter
    video snippet.description 5.000 byte
    video snippet.tags 500 karakter. Perhatikan bahwa nilai properti adalah daftar dan koma di antara item dalam daftar akan dihitung dalam batas.

  • Properti brandingSettings.watch.featuredPlaylistId resource channel tidak digunakan lagi. API akan menampilkan error jika Anda mencoba menetapkan nilainya.

  • Properti resource video berikut telah ditambahkan ke daftar nilai yang dapat ditetapkan saat menyisipkan atau memperbarui video:

  • Dokumentasi error kini menentukan kode respons HTTP untuk setiap jenis error.

  • API kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    badRequest (400) invalidCriteria Metode channels.list menampilkan error ini jika permintaan menentukan parameter filter yang tidak dapat digunakan bersama-sama.
    badRequest (400) channelTitleUpdateForbidden Metode channels.update menampilkan error ini jika Anda mencoba memperbarui bagian brandingSettings saluran dan mengubah nilai properti brandingSettings.channel.title. (Perhatikan bahwa API tidak akan menampilkan error jika Anda menghilangkan properti.)
    badRequest (400) invalidRecentlyUploadedBy Metode channels.update menampilkan error ini jika properti invideoPromotion.items[].id.recentlyUploadedBy menentukan ID channel yang tidak valid.
    badRequest (400) invalidTimingOffset Metode channels.update akan menampilkan error ini jika bagian invideoPromotion menentukan offset waktu yang tidak valid.
    badRequest (400) tooManyPromotedItems Metode channels.update akan menampilkan error ini jika bagian invideoPromotion mencantumkan lebih dari jumlah item yang dipromosikan yang diizinkan.
    forbidden (403) promotedVideoNotAllowed Metode channels.update menampilkan error ini jika properti invideoPromotion.items[].id.videoId menentukan ID video yang tidak dapat ditemukan atau tidak dapat digunakan sebagai item yang dipromosikan.
    forbidden (403) websiteLinkNotAllowed Metode channels.update akan menampilkan error ini jika properti invideoPromotion.items[].id.websiteUrl menentukan URL yang tidak diizinkan.
    required (400) requiredTimingType Metode channels.update akan menampilkan error ini jika permintaan tidak menentukan setelan waktu default terkait kapan YouTube harus menampilkan item yang dipromosikan.
    required (400) requiredTiming Metode channels.update harus menentukan objek invideoPromotion.items[].timing untuk setiap item yang dipromosikan.
    required (400) requiredWebsiteUrl Metode channels.update harus menentukan properti invideoPromotion.items[].id.websiteUrl untuk setiap item yang dipromosikan.
    badRequest (400) invalidPublishAt Metode videos.insert menampilkan error ini jika metadata permintaan menentukan waktu publikasi terjadwal yang tidak valid.

4 Maret 2014

Update ini berisi perubahan berikut:

5 Desember 2013

Update ini berisi perubahan berikut:

  • Dokumentasi metode search.list telah diperbarui untuk mencerminkan dengan benar bahwa Anda tidak perlu menentukan nilai untuk satu parameter filter secara tepat saat mengirimkan permintaan penelusuran. Namun, Anda dapat menetapkan nilai untuk parameter filter nol atau untuk satu parameter filter.

  • Definisi untuk parameter metode search.list telah diperbarui untuk mengetahui bahwa Anda harus menetapkan nilai parameter type ke video jika Anda juga menentukan nilai untuk salah satu parameter berikut:

    • eventType
    • videoCaption
    • videoCategoryId
    • videoDefinition
    • videoDimension
    • videoDuration
    • videoEmbeddable
    • videoLicense
    • videoSyndicated
    • videoType

  • Ukuran minimum gambar banner channel yang diupload telah dikurangi menjadi 2048x1152 piksel. (Sebelumnya, ukuran minimum adalah 2120 x 1192 piksel.) Selain itu, perhatikan bahwa dokumentasi resource channel menentukan ukuran maksimum semua gambar banner yang disajikan dari API. Misalnya, ukuran maksimum gambar brandingSettings.image.bannerTvImageUrl untuk aplikasi televisi adalah 2120x1192 piksel, tetapi gambar yang sebenarnya mungkin berukuran 2048x1152 piksel. Pusat Bantuan YouTube memberikan panduan tambahan untuk mengoptimalkan header channel agar dapat ditampilkan di berbagai jenis perangkat.

  • Beberapa definisi properti resource channel telah diperbarui untuk mencerminkan informasi berikut:

    • Nilai properti brandingSettings.channel.description memiliki panjang maksimum 1.000 karakter.
    • Properti brandingSettings.channel.featuredChannelsTitle memiliki panjang maksimum 30 karakter.
    • Properti brandingSettings.channel.featuredChannelsUrls[] kini dapat mencantumkan hingga 100 saluran.
    • Nilai properti brandingSettings.channel.unsubscribedTrailer, jika ditetapkan, harus menentukan ID video YouTube dari video publik atau tidak publik yang dimiliki oleh pemilik channel.

  • Metode channels.update kini mendukung pembaruan pada properti invideoPromotion.items[].promotedByContentOwner. Properti tersebut menunjukkan apakah nama pemilik konten akan ditampilkan saat menampilkan promosi. Nilai ini hanya dapat ditetapkan jika permintaan API yang menetapkan nilai properti dibuat atas nama pemilik konten menggunakan parameter onBehalfOfContentOwner.

  • Metode playlistItems.list dan playlistItems.insert kini mendukung parameter onBehalfOfContentOwner, yang sudah didukung untuk beberapa metode lainnya.

  • Properti contentDetails.contentRating.acbRating kini dapat menentukan rating dari Australian Classification Board (ACB) untuk film atau dari Australian Communications and Media Authority (ACMA) untuk program televisi anak-anak.

  • Properti contentDetails.contentRating.catvRating dan contentDetails.contentRating.catvfrRating yang baru mengidentifikasi rating yang diterima video menurut Sistem Klasifikasi TV Kanada dan sistem rating Régie du cinéma berbahasa Prancis, yang digunakan di Québec.

  • Properti snippet.assignable baru resource videoCategory menunjukkan apakah video yang diperbarui atau video yang baru diupload dapat dikaitkan dengan kategori video tersebut.

  • Contoh kode telah ditambahkan untuk metode berikut:

24 Oktober 2013

Update ini berisi perubahan berikut:

  • API ini mencakup dua fitur tambahan yang dirancang untuk membantu menemukan dan menampilkan konten live streaming:

    Properti snippet.liveBroadcastContent yang baru di hasil penelusuran menunjukkan apakah resource video atau channel memiliki konten live streaming. Nilai properti yang valid adalah upcoming, active, dan none.

    • Properti snippet.liveBroadcastContent baru dari resource video menunjukkan apakah video merupakan live streaming yang akan datang atau aktif. Daftar di bawah menjelaskan kemungkinan nilai properti:

      • upcoming – Video adalah live streaming yang belum dimulai.
      • active – Video adalah siaran live yang sedang berlangsung.
      • none – Video bukan siaran live mendatang atau aktif. Nilai ini akan menjadi nilai properti untuk siaran yang telah selesai, yang masih dapat dilihat di YouTube.

    • Properti liveStreamingDetails baru resource video adalah objek yang berisi metadata tentang siaran video live. Untuk mengambil metadata ini, sertakan liveStreamingDetails dalam daftar bagian resource nilai parameter part. Metadata menyertakan properti baru berikut:

      Untuk mengambil metadata ini, sertakan liveStreamingDetails dalam parameter value part saat memanggil metode videos.list, videos.insert, atau videos.update.

    Perlu diketahui bahwa dua fitur lain untuk mengidentifikasi konten live streaming dirilis pada 1 Oktober 2013 – parameter eventType metode search.list dan properti snippet.liveBroadcastContent hasil penelusuran.

  • Metode videos.insert kini mendukung parameter notifySubscribers, yang menunjukkan apakah YouTube harus mengirimkan notifikasi tentang video baru kepada pengguna yang subscribe ke channel video tersebut. Nilai default parameter ini adalah True, yang menunjukkan bahwa subscriber akan diberi tahu tentang video yang baru diupload. Namun, pemilik channel yang mengupload banyak video mungkin lebih memilih untuk menetapkan nilai ke False agar tidak mengirim notifikasi tentang setiap video baru kepada subscriber channel.

  • Daftar properti yang dapat diubah saat memanggil metode channels.update telah diperbarui untuk menyertakan properti invideoPromotion.items[].customMessage dan invideoPromotion.items[].websiteUrl. Selain itu, daftar telah diubah untuk mengidentifikasi properti brandingSettings yang dapat diubah. Properti brandingSettings ini sudah dapat diubah, sehingga perubahan dokumentasi tidak mencerminkan perubahan pada fungsi API yang ada.

  • Metode playlists.insert, playlists.update, dan playlists.delete kini mendukung parameter onBehalfOfContentOwner, yang sudah didukung untuk beberapa metode lainnya.

  • Metode playlists.insert kini mendukung parameter onBehalfOfContentOwnerChannel, yang sudah didukung untuk beberapa metode lainnya.

  • Properti contentDetails.contentRating.tvpgRating resource video kini mendukung nilai pg14, yang sesuai dengan rating TV-14.

  • Definisi properti snippet.liveBroadcastContent, yang merupakan bagian dari hasil penelusuran, telah dikoreksi untuk menunjukkan bahwa live adalah nilai properti yang valid, tetapi active bukan nilai properti yang valid.

  • Properti contentDetails.contentRating.mibacRating resource video kini mendukung dua rating tambahan:

    • mibacVap (VAP) – Anak-anak harus didampingi orang dewasa.
    • mibacVm6 (V.M.6) – Dibatasi untuk penonton berusia 6 tahun ke atas.
    • mibacVm12 (V.M.12) – Dibatasi untuk penonton berusia 12 tahun ke atas.

  • Properti invideoPromotion.items[].promotedByContentOwner baru pada resource channel menunjukkan apakah nama pemilik konten akan ditampilkan saat menampilkan promosi. Kolom ini hanya dapat ditetapkan jika permintaan API yang menetapkan nilai dibuat atas nama pemilik konten. Lihat parameter onBehalfOfContentOwner untuk informasi selengkapnya.

1 Oktober 2013

Update ini berisi perubahan berikut:

  • Objek auditDetails baru di resource channel berisi data channel yang akan dievaluasi oleh jaringan multi-channel (MCN) saat menentukan apakah akan menerima atau menolak channel tertentu. Perhatikan bahwa setiap permintaan API yang mengambil bagian resource ini harus memberikan token otorisasi yang berisi cakupan https://www.googleapis.com/auth/youtubepartner-channel-audit. Selain itu, token apa pun yang menggunakan cakupan tersebut harus dicabut saat MCN memutuskan untuk menerima atau menolak channel, atau dalam waktu dua minggu sejak tanggal token dikeluarkan.

  • Properti invideoPromotion.items[].id.type resource channel kini mendukung nilai recentUpload, yang menunjukkan bahwa item yang dipromosikan adalah video yang baru diupload dari channel tertentu.

    Secara default, channel sama dengan channel yang data promosi in-video-nya ditetapkan. Namun, Anda dapat mempromosikan video yang baru diupload dari channel lain dengan menetapkan nilai properti invideoPromotion.items[].id.recentlyUploadedBy yang baru ke ID channel untuk channel tersebut.

  • Resource channel berisi tiga properti baru – brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl – yang menentukan URL untuk gambar banner yang ditampilkan di halaman channel dalam aplikasi televisi.

  • Properti snippet.liveBroadcastContent yang baru di hasil penelusuran menunjukkan apakah resource video atau channel memiliki konten live streaming. Nilai properti yang valid adalah upcoming, active, dan none.

    • Untuk resource video, nilai upcoming menunjukkan bahwa video adalah siaran live yang belum dimulai, sedangkan nilai active menunjukkan bahwa video adalah siaran live yang sedang berlangsung.
    • Untuk resource channel, nilai upcoming menunjukkan bahwa saluran memiliki siaran terjadwal yang belum dimulai, sedangkan nilai acive menunjukkan bahwa saluran memiliki live streaming yang sedang berlangsung.

  • Di resource watermark, properti targetChannelId telah berubah dari objek menjadi string. Properti targetChannelId kini menentukan nilai itu sendiri, bukan berisi properti turunan yang menentukan ID channel YouTube dari channel yang ditautkan oleh gambar watermark. Oleh karena itu, properti targetChannelId.value resource telah dihapus.

  • Metode thumbnails.set kini mendukung parameter onBehalfOfContentOwner, yang sudah didukung untuk beberapa metode lainnya.

  • Metode search.list kini mendukung parameter eventType, yang membatasi penelusuran untuk hanya menampilkan peristiwa siaran aktif, mendatang, atau yang sudah selesai.

  • Properti contentDetails.contentRating.mibacRating baru mengidentifikasi rating yang diterima video dari Ministero dei Beni e delle Attivita Culturali e del Turismo Italia.

  • API kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    badRequest invalidImage Metode thumbnails.set menampilkan error ini jika konten gambar yang diberikan tidak valid.
    forbidden videoRatingDisabled Metode videos.rate menampilkan error ini jika pemilik video yang diberi rating telah menonaktifkan rating untuk video tersebut.

27 Agustus 2013

Update ini berisi perubahan berikut:

  • Resource watermark baru mengidentifikasi gambar yang ditampilkan selama pemutaran video channel tertentu. Anda juga dapat menentukan channel target yang akan ditautkan gambar serta detail pengaturan waktu yang menentukan kapan watermark muncul selama pemutaran video dan durasi waktunya terlihat.

    Metode watermarks.set mengupload dan menyetel gambar watermark channel. Metode watermarks.unset menghapus gambar watermark channel.

    Dokumentasi error menjelaskan pesan error yang didukung API secara khusus untuk metode watermarks.set dan watermarks.unset.

  • Properti statistics.hiddenSubscriberCount baru dari resource channel berisi nilai boolean yang menunjukkan apakah jumlah subscriber channel disembunyikan atau tidak. Dengan demikian, nilai properti adalah false jika jumlah subscriber channel dapat dilihat oleh publik.

  • Metode playlists.list kini mendukung parameter onBehalfOfContentOwner dan onBehalfOfContentOwnerChannel. Kedua parameter sudah didukung untuk beberapa metode lainnya.

  • Metode videos.list kini mendukung parameter regionCode, yang mengidentifikasi region konten tempat diagram harus diambil. Parameter ini hanya dapat digunakan bersama dengan parameter chart. Nilai parameter adalah kode negara ISO 3166-1 alpha-2.

  • error documentation menjelaskan error permintaan umum baru berikut, yang dapat terjadi untuk beberapa metode API:

    Jenis error Detail error Deskripsi
    forbidden insufficientPermissions Cakupan yang terkait dengan token OAuth 2.0 yang diberikan untuk permintaan tidak memadai untuk mengakses data yang diminta.

15 Agustus 2013

Update ini berisi perubahan berikut:

  • Objek invideoPromotion resource channel memiliki properti baru dan yang diperbarui berikut:

    • API ini kini mendukung kemampuan untuk menentukan situs sebagai item yang dipromosikan. Untuk melakukannya, tetapkan nilai properti invideoPromotion.items[].id.type ke website dan gunakan properti invideoPromotion.items[].id.websiteUrl baru untuk menentukan URL. Gunakan juga properti invideoPromotion.items[].customMessage yang baru untuk menentukan pesan kustom yang akan ditampilkan selama promosi.

      Link dapat mengarah ke situs terkait, situs penjual, atau situs jejaring sosial. Baca petunjuk Pusat Bantuan YouTube untuk situs terkait dan situs penjual guna mendapatkan informasi lebih lanjut terkait cara mengaktifkan link untuk konten Anda.

      Dengan menambahkan link promosi, Anda setuju bahwa link tersebut tidak akan digunakan untuk mengalihkan traffic ke situs yang tidak sah dan bahwa link tersebut akan mematuhi kebijakan AdWords, kebijakan iklan YouTube, Pedoman Komunitas YouTube, dan Persyaratan Layanan YouTube.

    • Properti yang terkait dengan setelan pengaturan waktu untuk menampilkan item yang dipromosikan selama pemutaran video telah direstrukturisasi:

      • Objek invideoPromotion.timing telah dipindahkan ke invideoPromotion.items[].timing. Objek ini kini memungkinkan Anda menyesuaikan data pengaturan waktu untuk setiap item yang dipromosikan dalam daftar invideoPromotion.items[].

      • Objek invideoPromotion.defaultTiming baru menentukan setelan pengaturan waktu default untuk promosi Anda. Setelan tersebut menentukan kapan item yang dipromosikan akan ditampilkan selama pemutaran salah satu video channel Anda. Anda dapat mengganti pengaturan waktu default untuk item yang dipromosikan tertentu menggunakan objek invideoPromotion.items[].timing.

      • Properti invideoPromotion.items[].timing.durationMs baru menentukan jumlah waktu, dalam milidetik, yang harus ditampilkan promosi. Objek invideoPromotion.defaultTiming juga berisi kolom durationMs yang menentukan jumlah waktu default saat item yang dipromosikan akan ditampilkan.

    • Properti invideoPromotion.items[].type dan invideoPromotion.items[].videoId telah dipindahkan ke objek invideoPromotion.items[].id.

  • Metode subscriptions.list kini mendukung parameter onBehalfOfContentOwner dan onBehalfOfContentOwnerChannel. Kedua parameter tersebut sudah didukung untuk beberapa metode lainnya.

  • Dalam respons API terhadap permintaan thumbnails.set, nilai properti kind telah berubah dari youtube#thumbnailListResponse menjadi youtube#thumbnailSetResponse.

  • Contoh kode telah ditambahkan untuk metode berikut:

    Perlu diperhatikan bahwa contoh Python untuk metode playlistItems.insert juga dihapus karena fungsi yang ditunjukkan kini ditangani oleh metode videos.rate.

  • error documentation menjelaskan error konteks permintaan baru berikut, yang dapat terjadi untuk metode API apa pun yang mendukung parameter permintaan mine:

    Jenis error Detail error Deskripsi
    badRequest invalidMine Parameter mine tidak dapat digunakan dalam permintaan yang penggunanya merupakan partner YouTube. Anda harus menghapus parameter mine, melakukan autentikasi sebagai pengguna YouTube dengan menghapus parameter onBehalfOfContentOwner, atau bertindak sebagai salah satu channel partner dengan memberikan parameter onBehalfOfContentOwnerChannel jika tersedia untuk metode yang dipanggil.

8 Agustus 2013

Update ini berisi perubahan berikut:

30 Juli 2013

Update ini berisi perubahan berikut:

  • Dalam resource channelBanner, nilai properti kind telah diubah dari youtube#channelBannerInsertResponse menjadi youtube#channelBannerResource. Resource ini ditampilkan sebagai respons terhadap permintaan channelBanners.insert.

  • Properti brandingSettings.channel.profileColor baru dari resource channel menentukan warna jelas yang melengkapi konten channel. Nilai properti adalah tanda pagar (#) yang diikuti dengan string heksadesimal enam karakter, seperti #2793e6.

  • API ini kini mendukung kemampuan untuk menentukan apakah subscription ditujukan untuk semua aktivitas channel atau hanya untuk upload baru. Properti contentDetails.activityType baru resource subscription mengidentifikasi jenis aktivitas yang akan diberi tahu kepada subscriber. Nilai properti yang valid adalah all dan uploads.

  • Metode videos.list mendukung parameter baru untuk mengambil diagram video terpopuler di YouTube:

    • Parameter chart mengidentifikasi diagram yang ingin Anda ambil. Saat ini, satu-satunya nilai yang didukung adalah mostPopular. Perhatikan bahwa parameter chart adalah parameter filter, yang berarti parameter tersebut tidak dapat digunakan dalam permintaan yang sama dengan parameter filter lainnya (id dan myRating).
    • Parameter videoCategoryId mengidentifikasi kategori video tempat diagram akan diambil. Parameter ini hanya dapat digunakan bersama dengan parameter chart. Secara default, diagram tidak dibatasi untuk kategori tertentu.

  • Properti topicDetails.relevantTopicIds[] baru resource video memberikan daftar ID topik Freebase yang relevan dengan video atau kontennya. Subjek topik ini dapat disebutkan dalam atau muncul dalam video.

  • Properti recordingDetails.location.elevation resource video telah diganti namanya menjadi recordingDetails.location.altitude, dan properti fileDetails.recordingLocation.location.elevation-nya telah diganti namanya menjadi fileDetails.recordingLocation.location.altitude.

  • Objek contentDetails.contentRating resource video menentukan rating yang diterima video berdasarkan berbagai skema rating, termasuk rating MPAA, rating TVPG, dan sebagainya. Untuk setiap sistem rating, API kini mendukung nilai rating yang menunjukkan bahwa video belum diberi rating. Perlu diperhatikan bahwa untuk rating MPAA, rating "belum diberi rating" sering digunakan untuk mengidentifikasi versi film tanpa rating yang versi potongannya sudah menerima rating resmi.

  • Properti contentDetails.contentRating.ytRating baru dari resource video mengidentifikasi konten yang dikenai pembatasan usia. Nilai properti akan menjadi ytAgeRestricted jika YouTube telah mengidentifikasi video tersebut berisi konten yang tidak sesuai untuk pengguna berusia di bawah 18 tahun. Jika properti tidak ada atau jika nilai properti kosong, konten tersebut belum diidentifikasi sebagai dikenai pembatasan usia.

  • Parameter mySubscribers metode channels.list tidak digunakan lagi. Gunakan metode subscriptions.list dan parameter mySubscribers-nya untuk mengambil daftar subscriber ke channel pengguna yang diautentikasi.

  • Metode channelBanners.insert, channels.update, videos.getRating, dan videos.rate kini mendukung parameter onBehalfOfContentOwner. Parameter tersebut menunjukkan bahwa pengguna terautentikasi bertindak atas nama pemilik konten yang ditentukan di nilai parameter.

  • Dokumentasi metode channels.update telah diperbarui untuk mencerminkan fakta bahwa metode tersebut dapat digunakan untuk memperbarui objek brandingSettings resource channel dan properti turunannya. Sekarang dokumentasi juga mencantumkan daftar properti terbaru yang dapat Anda tetapkan untuk objek invideoPromotion resource channel.

  • error documentation menjelaskan error baru berikut:

    Jenis error Detail error Deskripsi
    forbidden accountDelegationForbidden Error ini tidak spesifik untuk metode API tertentu. Hal ini menunjukkan bahwa pengguna terautentikasi tidak diberi otorisasi untuk bertindak atas nama Akun Google yang ditentukan.
    forbidden authenticatedUserAccountClosed Error ini tidak spesifik untuk metode API tertentu. Pesan ini menunjukkan bahwa akun YouTube pengguna terautentikasi ditutup. Jika pengguna bertindak atas nama Akun Google lain, error ini akan menunjukkan bahwa akun lain tersebut telah ditutup.
    forbidden authenticatedUserAccountSuspended Error ini tidak spesifik untuk metode API tertentu. Pesan ini menunjukkan bahwa akun YouTube pengguna yang diautentikasi ditangguhkan. Jika pengguna bertindak atas nama Akun Google lain, error ini akan menunjukkan bahwa akun lain ditangguhkan.
    forbidden authenticatedUserNotChannel Error ini tidak hanya terjadi pada metode API tertentu. Ini menunjukkan bahwa server API tidak dapat mengidentifikasi saluran yang terkait dengan permintaan API. Jika permintaan diberi otorisasi dan menggunakan parameter onBehalfOfContentOwner, Anda juga harus menetapkan parameter onBehalfOfContentOwnerChannel.
    forbidden cmsUserAccountNotFound Error ini tidak hanya terjadi pada metode API tertentu. Pengguna CMS tidak diizinkan untuk bertindak atas nama pemilik konten yang ditentukan.
    notFound contentOwnerAccountNotFound Error ini tidak hanya terjadi pada metode API tertentu. Akun pemilik konten yang ditentukan tidak ditemukan.
    badRequest invalidPart Error ini tidak hanya terjadi pada metode API tertentu. Parameter part permintaan menentukan bagian yang tidak dapat ditulis secara bersamaan.
    badRequest videoChartNotFound Metode videos.list menampilkan error ini saat permintaan menentukan diagram video yang tidak didukung atau tidak tersedia.
    notFound videoNotFound Metode videos.update menampilkan error ini untuk menunjukkan bahwa video yang Anda coba perbarui tidak dapat ditemukan. Periksa nilai properti id dalam isi permintaan untuk memastikan nilainya sudah benar.

10 Juni 2013

Update ini berisi perubahan berikut:

  • Parameter forUsername baru dari metode channels.list memungkinkan Anda mengambil informasi tentang channel dengan menentukan nama pengguna YouTube-nya.

  • Metode activities.list kini mendukung parameter regionCode, yang menginstruksikan API untuk menampilkan hasil yang relevan dengan negara yang ditentukan. YouTube menggunakan nilai ini jika aktivitas sebelumnya dari pengguna yang diotorisasi di YouTube tidak memberikan informasi yang memadai untuk membuat feed aktivitas.

  • Resource playlist kini berisi properti snippet.tags. Properti hanya akan ditampilkan kepada pengguna yang diotorisasi yang mengambil data tentang playlist mereka sendiri. Pengguna yang diberi otorisasi juga dapat menetapkan tag playlist saat memanggil metode playlists.insert atau playlists.update.

  • Parameter onBehalfOfContentOwner, yang sebelumnya didukung untuk metode channels.list dan search.list, kini juga didukung untuk metode videos.insert, videos.update, dan videos.delete. Perhatikan bahwa saat parameter ini digunakan dalam panggilan ke metode videos.insert, permintaan juga harus menentukan nilai untuk parameter onBehalfOfContentOwnerChannel baru, yang mengidentifikasi saluran tempat video akan ditambahkan. Channel harus ditautkan ke pemilik konten yang ditentukan oleh parameter onBehalfOfContentOwner.

    Parameter ini menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna YouTube CMS yang bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Akun CMS yang digunakan pengguna untuk melakukan autentikasi harus ditautkan ke pemilik konten YouTube yang ditentukan.

    Parameter ini ditujukan untuk partner konten yang memiliki dan mengelola banyak channel YouTube yang berbeda. Dengan parameter ini, partner tersebut dapat melakukan autentikasi satu kali dan mendapatkan akses ke semua data video dan channel mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel.

    Khusus untuk rilis ini, parameter ini kini memungkinkan partner konten menyisipkan, memperbarui, atau menghapus video di channel YouTube mana pun yang dimiliki partner tersebut.

  • error documentation menjelaskan error baru berikut:

    Jenis error Detail error Deskripsi
    forbidden insufficientCapabilities Error ini tidak spesifik untuk metode API tertentu. Hal ini menunjukkan bahwa pengguna CMS yang memanggil API tidak memiliki izin yang memadai untuk melakukan operasi yang diminta. Error ini terkait dengan penggunaan parameter onBehalfOfContentOwner, yang didukung untuk beberapa metode API.
    unauthorized authorizationRequired Metode activities.list menampilkan error ini saat permintaan menggunakan parameter home, tetapi tidak diberi otorisasi dengan benar.

  • Di resource channels, properti invideoPromotion.channelId telah dihapus karena ID channel sudah ditentukan menggunakan properti id resource.

  • Panduan baru Menggunakan ID Channel menjelaskan cara API menggunakan ID channel. Panduan ini mungkin sangat berguna bagi developer yang bermigrasi dari versi API sebelumnya dan memiliki aplikasi yang meminta konten untuk pengguna default atau yang mengandalkan gagasan bahwa setiap channel YouTube memiliki nama pengguna unik, yang tidak lagi berlaku.

22 Mei 2013

Update ini berisi perubahan berikut:

14 Mei 2013

Update ini berisi perubahan berikut:

  • Halaman mandiri kini mencantumkan contoh kode untuk Java, .NET, PHP, dan Ruby.

  • Halaman yang mencantumkan contoh kode Python kini menyertakan contoh untuk menambahkan langganan, membuat playlist, dan memperbarui video.

10 Mei 2013

Update ini berisi perubahan berikut:

8 Mei 2013

Update ini berisi perubahan berikut:

  • Resource channel kini mendukung objek inVideoPromotion, yang mengenkapsulasi informasi tentang kampanye promosi yang terkait dengan channel. Channel dapat menggunakan kampanye promosi in-video untuk menampilkan gambar thumbnail untuk video yang dipromosikan dalam pemutar video selama pemutaran video di channel tersebut.

    Anda dapat mengambil data ini dengan menyertakan invideoPromotion dalam nilai parameter part dalam permintaan channels.list.

  • Metode channels.update baru dapat digunakan untuk memperbarui data kampanye promosi in-video channel. Perhatikan bahwa metode ini hanya mendukung update pada bagian invideoPromotion resource channel dan belum mendukung update untuk bagian lain dari resource tersebut.

2 Mei 2013

Update ini berisi perubahan berikut:

  • Resource channel kini mendukung properti status.isLinked, yang menunjukkan apakah data channel mengidentifikasi pengguna yang sudah ditautkan ke nama pengguna YouTube atau akun Google+. Pengguna yang memiliki salah satu link ini sudah memiliki identitas YouTube publik, yang merupakan prasyarat untuk beberapa tindakan, seperti mengupload video.

  • Resource langganan kini mendukung bagian subscriberSnippet. Objek tersebut dienkapsulasi berisi data cuplikan untuk channel subscriber.

  • API tersebut kini mendukung metode videos.getRating, yang mengambil rating yang diberikan pengguna terautentikasi ke daftar satu atau beberapa video.

  • Parameter myRating baru dari metode videos.list memungkinkan Anda mengambil daftar video yang diberi rating oleh pengguna terautentikasi dengan rating like atau dislike.

    Parameter myRating dan parameter id kini dianggap sebagai parameter filter, yang berarti bahwa permintaan API harus menentukan salah satu parameter. (Sebelumnya, parameter id adalah parameter wajib untuk metode ini.)

    Metode ini menampilkan error forbidden untuk permintaan yang mencoba mengambil informasi rating video, tetapi tidak diberi otorisasi dengan benar untuk melakukannya.

  • Dengan diperkenalkannya parameter myRating, metode videos.list juga telah diperbarui untuk mendukung penomoran halaman. Namun, perlu diperhatikan bahwa parameter paging hanya didukung untuk permintaan yang menggunakan parameter myRating. (Informasi dan parameter paging tidak didukung untuk permintaan yang menggunakan parameter id.)

    • Parameter maxResults menentukan jumlah maksimum video yang dapat ditampilkan API dalam set hasil, dan parameter pageToken mengidentifikasi halaman tertentu dalam set hasil yang ingin Anda ambil.

    • Resource youtube#videoListResponse, yang ditampilkan sebagai respons terhadap permintaan videos.list, kini berisi objek pageInfo, yang berisi detail seperti jumlah total hasil dan jumlah hasil yang disertakan dalam set hasil saat ini. Resource youtube#videoListResponse juga dapat menyertakan properti nextPageToken dan prevPageToken, yang masing-masing menyediakan token yang dapat digunakan untuk mengambil halaman tertentu dalam kumpulan hasil.

  • Metode videos.insert mendukung parameter baru berikut:

    • autoLevels – Setel nilai parameter ini ke true untuk memerintahkan YouTube meningkatkan pencahayaan dan warna video secara otomatis.
    • stabilize – Tetapkan nilai parameter ini ke true untuk memerintahkan YouTube menyesuaikan video dengan menghilangkan guncangan yang disebabkan oleh gerakan kamera.

  • Properti channelTitle telah ditambahkan ke snippet untuk resource berikut:

    • playlistItem – Properti ini menentukan nama channel yang menambahkan item playlist.
    • playlist – Properti ini menentukan nama channel yang membuat playlist.
    • subscription – Properti menentukan nama channel yang disubscribe.

  • Contoh kode telah ditambahkan untuk metode berikut:

  • Parameter mySubscribers baru dari metode subscriptions.list memungkinkan Anda mengambil daftar pelanggan pengguna yang saat ini diautentikasi. Parameter ini hanya dapat digunakan dalam permintaan yang diotorisasi dengan benar.

    Catatan: Fungsi ini dimaksudkan untuk menggantikan parameter mySubscribers yang saat ini didukung untuk metode channels.list. Parameter tersebut tidak akan digunakan lagi.

  • Dalam resource video, nilai properti unspecified tidak lagi menjadi nilai yang mungkin untuk salah satu properti berikut:

  • Permintaan API yang berisi parameter tak terduga kini menampilkan error badRequest, dan alasan error yang dilaporkan adalah unexpectedParameter.

  • Error yang ditampilkan metode playlistItems.insert saat playlist sudah berisi jumlah maksimum item yang diizinkan telah diperbarui. Error kini dilaporkan sebagai error forbidden, dan alasan error-nya adalah playlistContainsMaximumNumberOfVideos.

19 April 2013

Update ini berisi perubahan berikut:

  • Metode videos.rate baru memungkinkan pengguna menyetel rating like atau dislike pada video atau menghapus rating dari video.

    Dokumentasi error juga telah diperbarui untuk mencantumkan error yang mungkin ditampilkan API sebagai respons terhadap panggilan metode videos.rate.

  • Gambar thumbnail kini diidentifikasi dalam dokumentasi API sebagai referensi terpisah, dan metode thumbnails.set yang baru memungkinkan Anda mengupload thumbnail video kustom ke YouTube dan menyetelnya untuk video.

    Dokumentasi error juga telah diperbarui untuk mencantumkan error yang mungkin ditampilkan API sebagai respons terhadap panggilan metode thumbnails.set.

    Perhatikan bahwa perubahan ini tidak benar-benar memengaruhi resource yang sudah ada yang menampilkan gambar thumbnail. Gambar thumbnail ditampilkan di resource tersebut dengan cara yang sama seperti sebelumnya, meskipun dokumentasi sekarang mencantumkan nama berbagai ukuran thumbnail yang mungkin ditampilkan oleh API.

  • Bagian brandingSettings baru pada resource channel mengidentifikasi setelan, teks, dan gambar untuk halaman channel dan halaman tonton video channel.

  • Resource playlistItem berisi properti baru berikut:

    • Objek status baru mengenkapsulasi informasi status tentang item playlist, dan properti status.privacyStatus mengidentifikasi status privasi item playlist.

  • Resource video berisi properti baru berikut:

  • Dokumentasi metode playlistItems.update telah diperbarui untuk mencerminkan fakta bahwa properti snippet.resourceId harus ditentukan dalam resource yang dikirim sebagai isi permintaan.

  • Metode search.list kini mendukung fungsi berikut:

    • Parameter forMine yang baru membatasi penelusuran agar hanya mengambil video pengguna yang diautentikasi.

    • Parameter order kini mendukung kemampuan untuk mengurutkan hasil menurut abjad berdasarkan judul (order=title) atau berdasarkan jumlah video dalam urutan menurun (order=videoCount).

    • Parameter safeSearch baru menunjukkan apakah hasil penelusuran harus menyertakan konten yang dibatasi.

  • Metode videos.insert mendukung beberapa error baru, yang tercantum dalam tabel di bawah:

    Jenis error Detail error Deskripsi
    badRequest invalidCategoryId Properti snippet.categoryId mencantumkan ID kategori yang tidak valid. Gunakan metode videoCategories.list untuk mengambil kategori yang didukung.
    badRequest invalidRecordingDetails metadata specifies invalid recording details.
    badRequest invalidVideoGameRating Metadata permintaan mencantumkan rating video game yang tidak valid.
    badRequest invalidVideoMetadata Metadata permintaan tidak valid.

  • Parameter onBehalfOfContentOwner telah dihapus dari daftar parameter yang didukung untuk metode videos.update dan videos.delete.

12 Maret 2013

Update ini berisi perubahan berikut:

  • Properti channelTitle telah ditambahkan ke snippet untuk resource berikut:

    • activity – Properti menentukan nama saluran yang bertanggung jawab atas aktivitas.
    • search – Properti menentukan nama saluran yang terkait dengan resource yang diidentifikasi oleh hasil penelusuran.
    • video – Properti menentukan nama channel yang mengupload video.

  • Metode search.list mendukung parameter baru berikut:

    • Parameter channelType memungkinkan Anda membatasi penelusuran channel untuk mengambil semua channel atau hanya mengambil acara.

    • Parameter videoType memungkinkan Anda membatasi penelusuran video untuk mengambil semua video atau hanya mengambil film atau hanya episode acara TV.

  • Definisi bagian recordingDetails resource video telah diperbarui untuk mencatat bahwa objek hanya akan ditampilkan untuk video jika data geolokasi video atau waktu perekaman telah ditetapkan.

  • Metode playlistItems.update kini menampilkan error invalidSnippet, yang ditampilkan jika permintaan API tidak menentukan cuplikan yang valid.

  • Beberapa metode API mendukung parameter baru yang ditujukan secara eksklusif untuk partner konten YouTube. Partner konten YouTube mencakup studio film dan televisi, label rekaman, serta kreator konten lainnya yang menyediakan konten mereka di YouTube.

    • Parameter onBehalfOfContentOwner menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna YouTube CMS yang bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Akun CMS yang digunakan pengguna untuk melakukan autentikasi harus ditautkan ke pemilik konten YouTube yang ditentukan.

      Parameter ini ditujukan untuk partner konten yang memiliki dan mengelola berbagai channel YouTube. Parameter ini memungkinkan partner tersebut melakukan autentikasi satu kali dan mendapatkan akses ke semua data video dan channel mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel.

      Semua metode channels.list, search.list, videos.delete, videos.list, dan videos.update mendukung parameter ini.

    • Parameter managedByMe, yang didukung oleh metode channels.list, menginstruksikan API untuk menampilkan semua channel yang dimiliki oleh pemilik konten yang ditentukan oleh parameter onBehalfOfContentOwner.

    • Parameter forContentOwner, yang didukung oleh metode search.list, menginstruksikan API untuk membatasi hasil penelusuran agar hanya menyertakan resource yang dimiliki oleh pemilik konten yang ditentukan oleh parameter onBehalfOfContentOwner.

25 Februari 2013

Update ini berisi perubahan berikut:

  • API ini mendukung beberapa bagian dan properti baru untuk resource video:

    • Bagian fileDetails, processingDetails, dan suggestions yang baru memberikan informasi kepada pemilik video tentang video yang mereka upload. Data ini sangat berguna dalam aplikasi yang mengaktifkan upload video dan mencakup hal berikut:

      • status dan progres pemrosesan
      • error atau masalah lainnya yang terjadi saat memproses video
      • ketersediaan gambar thumbnail
      • saran untuk meningkatkan kualitas video atau metadata
      • detail tentang file asli yang diupload ke YouTube

      Semua bagian ini hanya dapat diambil oleh pemilik video. Daftar di bawah ini menjelaskan secara singkat bagian-bagian baru, dan dokumentasi resource video menentukan semua properti yang terdapat dalam setiap bagian.

      • Objek fileDetails berisi informasi tentang file video yang diupload ke YouTube, termasuk resolusi, durasi, codec audio dan video, kecepatan bit streaming, dan lainnya.

      • Objek processingProgress berisi informasi tentang progres YouTube dalam memproses file video yang diupload. Properti objek mengidentifikasi status pemrosesan saat ini dan memperkirakan waktu yang tersisa hingga YouTube selesai memproses video. Bagian ini juga menunjukkan apakah berbagai jenis data atau konten, seperti detail file atau gambar thumbnail, tersedia untuk video.

        Objek ini dirancang untuk polling, sehingga uploader video dapat melacak progres yang telah dibuat YouTube dalam memproses file video yang diupload.

      • Objek suggestions berisi saran yang mengidentifikasi peluang untuk meningkatkan kualitas video atau metadata untuk video yang diupload.

    • Bagian contentDetails berisi empat properti baru. Properti ini dapat diambil dengan permintaan yang tidak diautentikasi.

      • dimension – Menunjukkan apakah video tersedia dalam 2D atau 3D.
      • definition – Menunjukkan apakah video tersedia dalam definisi standar atau tinggi.
      • caption – Menunjukkan apakah teks tersedia untuk video.
      • licensedContent – Menunjukkan apakah video berisi konten yang telah diklaim oleh partner konten YouTube.

    • Bagian status berisi dua properti baru. Pemilik video dapat menyetel nilai untuk kedua properti saat menyisipkan atau memperbarui video. Properti ini juga dapat diambil dengan permintaan yang tidak diautentikasi.

      • embeddable – Menunjukkan apakah video dapat disematkan di situs lain.
      • license – Menentukan lisensi video. Nilai yang valid adalah creativeCommon dan youtube.

  • Definisi parameter part telah diperbarui untuk metode videos.list, videos.insert, dan videos.update guna mencantumkan bagian yang baru ditambahkan yang dijelaskan di atas serta bagian recordingDetails, yang tidak sengaja dihilangkan.

  • Properti contentDetails.googlePlusUserId baru resource channel menentukan ID profil Google+ yang terkait dengan channel. Nilai ini dapat digunakan untuk membuat link ke profil Google+.

  • Setiap objek gambar thumbnail kini menentukan lebar dan tinggi gambar. Gambar thumbnail saat ini ditampilkan di resource activity, channel, playlist, playlistItem, search result, subscription, dan video.

  • playlistItems.list kini mendukung parameter videoId, yang dapat digunakan bersama dengan parameter playlistId untuk hanya mengambil item playlist yang mewakili video yang ditentukan.

    API akan menampilkan error notFound jika video yang diidentifikasi parameter tidak dapat ditemukan dalam playlist.

  • Dokumentasi error menjelaskan error forbidden baru, yang menunjukkan bahwa permintaan tidak diberi otorisasi dengan benar untuk tindakan yang diminta.

  • Properti snippet.channelId resource channel telah dihapus. Properti id resource memberikan nilai yang sama.

30 Januari 2013

Update ini berisi perubahan berikut:

  • Halaman error baru mencantumkan error yang dapat ditampilkan API. Halaman ini menyertakan error umum, yang mungkin terjadi untuk beberapa metode API yang berbeda, serta error spesifik per metode.

16 Januari 2013

Update ini berisi perubahan berikut:

  • Contoh kode kini tersedia untuk metode dan bahasa yang ditampilkan dalam daftar di bawah:

  • Resource activity kini dapat melaporkan tindakan channelItem, yang terjadi saat YouTube menambahkan video ke channel YouTube yang dibuat secara otomatis. (YouTube secara algoritmis mengidentifikasi topik yang memiliki kehadiran signifikan di situs web YouTube dan secara otomatis membuat saluran untuk topik tersebut.)

  • Parameter search.list berikut telah diperbarui:

    • Parameter q tidak lagi ditetapkan sebagai filter, yang berarti ....
    • Parameter relatedToVideo telah diganti namanya menjadi relatedToVideoId.
    • Parameter published telah diganti dengan dua parameter baru, publishedAfter dan publishedBefore, yang dijelaskan di bawah.

  • Metode search.list mendukung parameter baru berikut:

    Nama parameter Nilai Deskripsi
    channelId string Menampilkan resource yang dibuat oleh channel yang ditentukan.
    publishedAfter datetime Menampilkan resource yang dibuat setelah waktu yang ditentukan.
    publishedBefore datetime Menampilkan resource yang dibuat sebelum waktu yang ditentukan.
    regionCode string Menampilkan resource untuk negara yang ditentukan.
    videoCategoryId string Memfilter hasil penelusuran video agar hanya menyertakan video yang terkait dengan kategori video yang ditentukan.
    videoEmbeddable string Filter hasil penelusuran video agar hanya menyertakan video yang dapat diputar dalam pemutar tersemat di halaman web. Tetapkan parameter value ke true untuk hanya mengambil video yang dapat disematkan.
    videoSyndicated string Memfilter hasil penelusuran video agar hanya menyertakan video yang dapat diputar di luar YouTube.com. Tetapkan nilai parameter ke true untuk hanya mengambil video yang disindikasikan.

  • Beberapa resource API mendukung properti baru. Tabel di bawah mengidentifikasi resource dan properti barunya:

    Resource Nama properti Nilai Deskripsi
    activity contentDetails.playlistItem.playlistItemId string ID item playlist yang ditetapkan YouTube untuk mengidentifikasi item dalam playlist secara unik.
    activity contentDetails.channelItem object Objek yang berisi informasi tentang resource yang ditambahkan ke saluran. Properti ini hanya ada jika snippet.type adalah channelItem.
    activity contentDetails.channelItem.resourceId object Objek yang mengidentifikasi resource yang ditambahkan ke channel. Seperti properti resourceId lainnya, properti ini berisi properti kind yang menentukan jenis resource, seperti video atau playlist. Elemen ini juga berisi tepat satu dari beberapa properti – videoId, playlistId, dll. – yang menentukan ID yang mengidentifikasi resource tersebut secara unik.
    channel status object Objek ini mengenkapsulasi informasi tentang status privasi channel.
    channel status.privacyStatus string Status privasi channel. Nilai yang valid adalah private dan public.
    playlist contentDetails object Objek ini berisi metadata tentang konten playlist.
    playlist contentDetails.itemCount unsigned integer Jumlah video dalam playlist.
    playlist player object Objek ini berisi informasi yang akan Anda gunakan untuk memutar playlist di pemutar tersemat.
    playlist player.embedHtml string Tag <iframe> yang menyematkan pemutar video yang memutar playlist.
    video recordingDetails object Objek ini mengenkapsulasi informasi yang mengidentifikasi atau mendeskripsikan tempat dan waktu perekaman video.
    video recordingDetails.location object Objek ini berisi informasi geolokasi yang terkait dengan video.
    video recordingDetails.location.latitude double Lintang dalam derajat.
    video recordingDetails.location.longitude double Bujur dalam derajat.
    video recordingDetails.location.elevation double Ketinggian di atas Bumi, dalam meter.
    video recordingDetails.locationDescription string Deskripsi teks yang menunjukkan lokasi perekaman video.
    video recordingDetails.recordingDate datetime Tanggal dan waktu video direkam. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

  • Dokumentasi untuk beberapa metode API kini mengidentifikasi properti yang harus ditentukan dalam isi permintaan atau yang diupdate berdasarkan nilai dalam isi permintaan. Tabel di bawah mencantumkan metode tersebut serta properti wajib atau yang dapat diubah.

    Catatan: Dokumentasi untuk metode lain mungkin sudah mencantumkan properti yang diperlukan dan dapat diubah.

    Metode Properti
    activities.insert Properti wajib:
    • snippet.description
    Properti yang dapat diubah:
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update Properti yang diperlukan:
    • id
    playlistItems.update Properti yang diperlukan:
    • id
    videos.update Properti yang diperlukan:
    • id

  • API tidak lagi melaporkan error playlistAlreadyExists jika Anda mencoba membuat atau memperbarui playlist yang akan memiliki judul yang sama dengan playlist yang sudah ada di saluran yang sama.

  • Beberapa metode API mendukung jenis error baru. Tabel di bawah mengidentifikasi metode dan error yang baru didukung:

    Metode Jenis error Detail error Deskripsi
    guideCategories.list notFound notFound Kategori panduan yang diidentifikasi oleh parameter id tidak dapat ditemukan. Gunakan metode guideCategories.list untuk mengambil daftar nilai yang valid.
    playlistItems.delete forbidden playlistItemsNotAccessible Permintaan tidak diberi otorisasi dengan benar untuk menghapus item playlist yang ditentukan.
    videoCategories.list notFound videoCategoryNotFound Kategori video yang diidentifikasi oleh parameter id tidak dapat ditemukan. Gunakan metode videoCategories.list untuk mengambil daftar nilai yang valid.