YouTube Live Streaming API - Histori Revisi

Halaman ini mencantumkan perubahan YouTube Live Streaming API dan update dokumentasi.

12 Oktober 2026

Update ini berisi perubahan berikut:

18 Agustus 2026

Update ini berisi perubahan berikut:

  • Dokumentasi untuk metode liveBroadcasts.update telah diperbarui untuk menyertakan error baru terkait monetisasi: preconditionFailed (412) (alasan: videoNotEligibleForAdsMonetization) dan backendError (503) (alasan: backendError).

17 Agustus 2026

Update ini berisi perubahan berikut:

  • Properti snippet.categoryId baru dari resource liveBroadcast memungkinkan Anda menetapkan, memperbarui, dan mengambil kategori video yang terkait dengan live streaming.

20 Juli 2026

Update ini berisi perubahan berikut:

9 Juli 2026

Update ini berisi perubahan berikut:

1 Juni 2026

Update ini berisi perubahan berikut:

  • Properti contentDetails.availabilityConfig resource liveBroadcast memungkinkan Anda menentukan pembatasan geografis untuk live streaming sehingga Anda dapat mengelola ketersediaan regional untuk acara live.

26 Maret 2026

Update ini berisi perubahan berikut:

  • Properti snippet.type kini mendukung nilai baru giftEvent.

  • Properti snippet.giftEventDetails baru resource liveChatMessage dan turunannya berisi informasi tentang acara pemberian hadiah.

12 Januari 2026

API kini mendukung pengaktifan midroll dan penyisipan midroll otomatis untuk live streaming.

Pemilik siaran dapat memilih untuk mengaktifkan mid-roll untuk siaran selama siaran tersebut memenuhi syarat untuk mid-roll. Pemilik juga dapat menonaktifkan mid-roll untuk siaran kapan saja.

Jika siaran diaktifkan untuk mid-roll, pemilik siaran dapat memilih untuk mengaktifkan penyisipan mid-roll otomatis. Mereka juga dapat menonaktifkan iklan otomatis untuk siaran kapan saja.

Saat mengaktifkan iklan otomatis, pemilik siaran dapat memilih salah satu opsi berikut:

  • Izinkan YouTube mengoptimalkan penyisipan mid-roll. Opsi ini mendukung tiga mode:
    • Rendah: potensi penghasilan lebih rendah, pengalaman penonton tidak terlalu terganggu
    • Sedang: potensi penghasilan sedang, pengalaman penonton seimbang
    • Tinggi: potensi penghasilan lebih tinggi, pengalaman penonton lebih terganggu
  • Konfigurasikan strategi dan interval untuk penyisipan mid-roll secara manual. Dalam hal ini, pemilik harus menyiapkan dua parameter:
    1. Strategi penjadwalan untuk titik tanda iklan. Titik cue dapat disisipkan secara bersamaan untuk semua penonton atau waktu titik cue dapat bervariasi dari penonton ke penonton. Strategi terakhir memungkinkan YouTube menjadwalkan titik cue dengan kecepatan yang lebih tinggi sehingga penonton dapat menerima titik cue saat mereka memenuhi syarat untuk melakukannya.
    2. Panjang interval antara jeda iklan mid-roll.

Dokumentasi mencerminkan perubahan API berikut untuk mendukung fitur ini:

  • Objek monetizationDetails resource liveBroadcast berisi kolom untuk pengaktifan mid-roll dan konfigurasi iklan otomatis.
  • Metode update dapat digunakan untuk mengaktifkan atau menonaktifkan iklan mid-roll. Metode tersebut juga dapat digunakan untuk menyiapkan iklan otomatis untuk live streaming. Dokumentasi mengidentifikasi beberapa error baru yang dapat terjadi saat memperbarui setelan monetisasi dan iklan otomatis untuk live streaming.

14 Juli 2025

Deskripsi metode liveChatMessages.streamList telah diperbarui untuk memberikan panduan tentang penggunaan streamList API.

9 Oktober 2023

Sebagai referensi saja, Anda dapat menemukan ID Stiker yang terkait dengan Super Stickers di file CSV ini. Definisi properti snippet.superStickerDetails.superStickerMetadata.stickerId resource liveChatMessage dan properti snippet.superStickerMetadata.stickerId resource superChatEvent telah diperbarui untuk mencerminkan informasi ini.

15 September 2023

API ini kini mendukung cara baru untuk menyisipkan iklan ke dalam live streaming. Selain liveCuepoints, yang memungkinkan Anda menyisipkan jeda iklan secara manual ke dalam siaran, YouTube kini mendukung fitur untuk menyisipkan jeda iklan mid-roll secara otomatis ke dalam siaran pada interval tetap.

Jika pemilik siaran mengaktifkan iklan otomatis, mereka dapat melihat aspek perilaku iklan berikut:

  • panjang interval antara jeda iklan mid-roll.
  • strategi penjadwalan untuk titik tanda iklan. Cuepoint dapat disisipkan secara bersamaan untuk semua penonton atau waktu cuepoint dapat bervariasi dari penonton ke penonton. Strategi terakhir memungkinkan YouTube menjadwalkan titik cuplikan dengan kecepatan yang lebih tinggi sehingga penonton dapat menerima titik cuplikan saat mereka memenuhi syarat untuk melakukannya.
  • periode saat iklan mid-roll tidak ditampilkan; untuk fitur ini, pemilik siaran menentukan bahwa penyisipan iklan mid-roll dijeda hingga waktu tertentu.

Dokumentasi ini mencerminkan perubahan API berikut untuk mendukung fitur ini:

  • Resource liveBroadcast kini berisi objek monetizationDetails. Kolom objek menunjukkan apakah penyisipan iklan otomatis diaktifkan untuk siaran dan menentukan informasi tambahan untuk menjadwalkan cuepoint.
  • Parameter part metode liveBroadcast.list mendukung nilai monetizationDetails.
  • Metode update dapat digunakan untuk menjeda penyisipan iklan mid-roll selama jangka waktu tertentu untuk live streaming. Dokumentasi ini juga mengidentifikasi beberapa error yang dapat terjadi saat memperbarui detail monetisasi untuk live streaming.

1 Agustus 2023

Update ini berisi perubahan berikut:

  • Metode liveBroadcasts.update tidak lagi memerlukan nilai yang ditentukan untuk kolom berikut:

    • snippet.title
    • status.privacyStatus

    Jika kolom ini dihilangkan dari permintaan, kolom tersebut tidak akan berubah.

1 November 2022

  • Metode liveBroadcasts.cuepoint baru memungkinkan pemilik channel yang menjalankan live streaming di YouTube untuk menyisipkan cuepoint ke siaran tersebut, yang dapat memicu jeda iklan. Metode ini menggantikan metode liveCuepoints.insert, yang hanya memungkinkan partner konten YouTube menyisipkan cuepoint ke dalam live streaming.

    Beberapa panduan telah diperbarui untuk mencerminkan ketersediaan metode baru ini.

  • Catatan: Ini adalah pengumuman penghentian penggunaan.

    Metode liveCuepoints.insert kini tidak digunakan lagi. Dukungan untuk metode liveCuepoints.insert akan dihapus pada atau setelah 1 Mei 2023. Pengguna API harus mengupdate aplikasi mereka untuk memanggil metode liveBroadcasts.cuepoint sebagai gantinya.

  • Dokumentasi untuk metode liveBroadcasts.control telah dihapus. Pemberitahuan penghentian penggunaan untuk metode tersebut telah diposting pada September 2020.

1 Oktober 2022

Update ini berisi perubahan berikut:

  • Metode liveBroadcasts.update tidak lagi memerlukan nilai yang ditentukan untuk kolom berikut:

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

    Jika kolom ini dihilangkan dari permintaan, kolom tersebut tidak akan berubah.

  • Menghapus dokumentasi untuk kolom liveBroadcast yang sudah tidak digunakan lagi:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1 April 2022

Update ini berisi perubahan berikut:

15 September 2021

Update ini berisi perubahan berikut:

  • Properti snippet.type kini mendukung dua nilai baru:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • Properti snippet.memberMilestoneChatDetails baru dari resource liveChatMessage dan turunannya berisi informasi tentang peristiwa Chat Pencapaian Pelanggan. Demikian pula, properti snippet.newSponsorDetails baru dan turunannya berisi informasi tentang acara Sponsor Baru.

1 Desember 2020

Metode liveBroadcasts.transition API mendukung error 403 (Forbidden) baru, yang menunjukkan bahwa pengguna telah mengirim terlalu banyak permintaan dalam jangka waktu tertentu. Alasan error adalah userRequestsExceedRateLimit.

21 September 2020

  • Definisi properti status.madeForKids resource liveBroadcast telah diperbarui untuk memperjelas bahwa properti bersifat hanya baca. Hal ini tidak mencerminkan perubahan pada fungsi API.

    Untuk menetapkan live streaming sebagai ditujukan untuk anak-anak, tetapkan properti status.selfDeclaredMadeForKids ke true saat memanggil metode liveBroadcasts.insert untuk membuat siaran.

  • Catatan: Perubahan ini mencakup pengumuman penghentian penggunaan dan pembaruan pengumuman penghentian penggunaan sebelumnya.

    Metode liveBroadcasts.control tidak akan digunakan lagi pada atau setelah 1 Oktober 2020. Setelah tanggal tersebut, semua panggilan ke metode ini akan menampilkan error dilarang (403), dan metode ini nantinya akan dihapus sepenuhnya. Klien masih dapat menerapkan slate mereka sendiri dengan menambahkan overlay ke video yang dikirim ke server penyerapan YouTube.

    Tanggal penghentian untuk pengumuman penghentian yang dibuat pada 16 April 2020, yang awalnya dijadwalkan pada 1 September 2020, telah ditunda dan sekarang akan terjadi pada atau setelah 1 Oktober 2020. Oleh karena itu, fitur yang disertakan dalam pengumuman penghentian penggunaan tersebut dan metode liveBroadcasts.control akan dihentikan penggunaannya secara bersamaan.

17 Juli 2020

Catatan: Ini adalah pembaruan untuk pengumuman penghentian penggunaan sebelumnya.

Kolom cdn.format resource liveStream, yang tidak digunakan lagi pada April 2016, tidak akan didukung lagi mulai 17 Agustus 2020. Permintaan yang masih menggunakan kolom tersebut akan gagal mulai tanggal tersebut.

Jika kode Anda masih menggunakan kolom cdn.format, kode tersebut harus diupdate untuk menentukan kecepatan frame dan resolusi secara terpisah, menggunakan properti cdn.frameRate dan cdn.resolution.

6 Juli 2020

Panduan Menayangkan Konten YouTube Live melalui HLS telah diperbarui dengan beberapa perubahan:

Selain itu, perbandingan protokol penyerapan baru mencantumkan protokol penyerapan yang didukung YouTube, codec yang didukung untuk setiap protokol, dan informasi tambahan mengenai kasus penggunaan yang sesuai untuk setiap protokol.

16 April 2020

Pembaruan ini mencakup properti baru dan pengumuman penghentian:

  • Resource liveBroadcast kini mendukung properti contentDetails.enableAutoStop. Properti ini menunjukkan apakah siaran harus berhenti secara otomatis sekitar satu menit setelah pemilik channel berhenti melakukan streaming video di streaming video yang terikat.

    Dokumen siklus proses siaran telah diperbarui untuk menjelaskan cara langkah demi langkah membuat dan mengelola acara live YouTube berubah jika Anda menyetel properti contentDetails.enableAutoStart atau contentDetails.enableAutoStop ke true.

  • Catatan: Ini adalah pengumuman penghentian penggunaan. Perubahan ini akan mulai berlaku pada atau setelah 1 September 2020. Tanggal sebenarnya saat perubahan berlaku disebut di bawah sebagai tanggal penghentian penggunaan.

    Update ini menjelaskan potensi perubahan yang dapat menyebabkan gangguan. Hal ini memengaruhi aplikasi klien API yang menggunakan resource liveStream dan liveBroadcast default channel untuk melakukan streaming konten live di YouTube. Khususnya, ID siaran dan ID streaming yang terkait dengan siaran dan streaming persisten tidak akan lagi berfungsi untuk memulai siaran baru.

    Aplikasi Anda akan terpengaruh jika salah satu hal berikut berlaku:

    • Fungsi ini memeriksa nilai properti liveBroadcast isDefaultBroadcast resource. Properti ini tidak akan ditampilkan setelah tanggal penghentian penggunaan.
    • Aturan ini memeriksa nilai properti isDefaultStream resource liveStream. Properti ini tidak akan ditampilkan setelah tanggal penghentian penggunaan.
    • Metode ini memanggil metode liveBroadcasts.list dan menetapkan parameter value broadcastType ke persistent atau all. Parameter ini tidak akan digunakan lagi sebagai bagian dari perubahan ini. Mulai tanggal penghentian:
      • Jika nilai parameter broadcastType adalah persistent, maka metode liveBroadcasts.list tidak akan menampilkan hasil apa pun.
      • Jika nilai parameter broadcastType adalah all, metode liveBroadcasts.list tidak akan menampilkan siaran persisten yang ada sebelum waktu tersebut.

    Sebagai latar belakang, selama beberapa tahun terakhir, YouTube telah otomatis membuat streaming default dan siaran default untuk channel saat channel tersebut diaktifkan untuk live streaming. Streaming default ada tanpa batas waktu, tidak memiliki waktu mulai atau berakhir yang terkait, dan tidak dapat dihapus. Demikian pula, siaran default dianggap persisten. Parameter ini selalu ada dan tidak terikat ke peristiwa tertentu.

    Mulai tanggal penghentian:

    • YouTube tidak akan lagi membuat streaming dan siaran default. Daripada mengandalkan resource default, klien API harus dapat membuat dan mengelola resource liveBroadcast dan liveStream serta mengikat resource tersebut bersama-sama.
    • Jika siaran default dan streaming default channel sedang aktif, yang berarti channel menggunakannya untuk live streaming pada saat penghentian berlaku, siaran yang sedang berlangsung tidak akan terpengaruh. Namun, setelah siaran tersebut berakhir, channel tidak akan dapat menggunakan siaran default dan streaming default lagi.
    • Jika siaran default dan streaming default channel tidak aktif secara live, setelah penghentian berlaku, YouTube akan mengabaikan upaya untuk menggunakan resource tersebut untuk menyiarkan video.

    Jika aplikasi Anda terpengaruh, lihat dokumen berikut, yang akan membantu Anda mengupdate aplikasi agar tetap berfungsi seperti yang diharapkan setelah perubahan ini:

    • Panduan migrasi baru mencoba menjelaskan langkah-langkah yang mungkin perlu dilakukan developer di klien API yang saat ini menggunakan siaran dan streaming default.
    • Panduan Siklus proses siaran akan memandu Anda melalui proses langkah demi langkah yang menjelaskan cara membuat dan mengelola acara live di YouTube. Setiap langkah menjelaskan panggilan API atau hal lain yang perlu Anda lakukan untuk menyelesaikan tindakan tertentu, dan aplikasi Anda harus mengikuti proses tersebut saat YouTube berhenti mendukung streaming dan siaran default.

31 Maret 2020

Catatan: Ini adalah pengumuman penghentian penggunaan.

Resource sponsor dan metode sponsors.list telah dihentikan dan diganti dengan resource member dan metode members.list.

Metode sponsors.list tidak akan lagi didukung pada atau setelah 30 September 2020. Klien API harus memperbarui panggilan ke metode sponsors.list untuk menggunakan metode members.list. Lihat histori revisi YouTube Data API untuk mengetahui informasi selengkapnya tentang resource baru.

11 Maret 2020

Bagian Endpoint penyerapan dalam panduan Menayangkan Konten YouTube Live melalui HLS telah diperbarui untuk menjelaskan proses yang harus digunakan encoder untuk melengkapi nilai parameter file= saat membentuk URL penyerapan utama dan cadangan.

4 Februari 2020

Panduan Menyampaikan Konten YouTube Live melalui HLS telah diperbarui untuk mencatat bahwa permintaan DELETE bersifat opsional dan endpoint HLS YouTube mengabaikannya. Untuk alasan performa, YouTube merekomendasikan agar klien tidak mengirim permintaan DELETE.

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 "dibuat untuk anak-anak" di Pusat Bantuan YouTube.

  • Resource liveBroadcast mendukung dua properti baru untuk memungkinkan kreator konten dan penonton mengidentifikasi konten "Dibuat untuk Anak-Anak":
    • Properti selfDeclaredMadeForKids memungkinkan kreator konten menentukan apakah live streaming adalah konten yang ditujukan untuk anak-anak. Properti ini dapat ditetapkan saat membuat siaran melalui metode liveBroadcasts.insert. Perhatikan bahwa properti ini hanya disertakan dalam respons API yang berisi resource liveBroadcast jika pemilik channel mengizinkan permintaan API.
    • Properti madeForKids memungkinkan pengguna API mengambil status "Dibuat untuk Anak-Anak" dari suatu siaran. Misalnya, status dapat ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang cara menetapkan audiens untuk channel, video, atau siaran Anda.
  • Di YouTube Data API, resource channel juga mendukung properti selfDeclaredMadeForKids dan madeForKids baru.

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

20 Agustus 2019

Bagian Persyaratan dalam panduan Menayangkan Konten YouTube Live melalui HLS telah diperbarui dengan dua perubahan:

  • Dokumen ini menjelaskan bahwa praktik terbaiknya adalah menyertakan segmen yang diakui dan segmen yang belum diakui di setiap Playlist Media. Praktik ini membuat segmen lebih kecil kemungkinannya untuk dilewati jika Playlist Media hilang di sisi server. Misalnya, Anda dapat menyertakan hingga dua segmen yang telah dikonfirmasi dan hingga lima segmen yang belum dikonfirmasi di setiap Playlist Media.
  • Sekarang, Playlist Media wajib dikirim untuk setiap Segmen Media. Hal ini memungkinkan server pulih dengan cepat jika Playlist Media hilang. Praktik ini sebelumnya tercantum sebagai rekomendasi.

28 Juni 2019

YouTube kini mendukung penyerapan HLS. Oleh karena itu, properti ingestionType resource liveStream mendukung nilai baru hls untuk mengidentifikasi streaming yang diserap ke YouTube menggunakan HLS.

Panduan Menyampaikan Konten YouTube Live melalui HLS yang baru memberikan pedoman untuk menggunakan HLS guna melakukan streaming konten live ke YouTube dari encoder. Panduan ini bertujuan untuk membantu vendor encoder menambahkan dukungan penayangan HLS ke produk mereka.

4 April 2019

Update ini berisi perubahan berikut:

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

    • Widget APIs Explorer memungkinkan Anda memilih cakupan otorisasi, memasukkan contoh nilai parameter dan properti, lalu mengirim permintaan API sebenarnya dan melihat respons API sebenarnya. Widget ini juga menawarkan tampilan layar penuh yang menampilkan contoh kode lengkap, yang diupdate 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 liveBroadcasts.list untuk mengambil data tentang siaran tertentu atau untuk mengambil data tentang siaran pengguna saat ini.

      Anda dapat menggunakan link di bagian tersebut untuk mengisi APIs Explorer dengan nilai contoh untuk kasus penggunaan Anda atau untuk membuka APIs Explorer layar penuh dengan nilai yang sudah diisi. Perubahan ini bertujuan untuk memudahkan Anda melihat contoh kode yang dapat langsung diterapkan pada kasus penggunaan yang ingin Anda terapkan di aplikasi Anda sendiri.

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

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

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

25 Februari 2019

Dokumentasi resource liveChatMessage dan superChatEvent telah diperbarui untuk mencerminkan fakta bahwa kedua resource tersebut kini dapat berisi informasi tentang Super Stickers. Super Stickers adalah jenis pesan Super Chat yang menampilkan gambar. Seperti Super Chat lainnya, pesan Super Stickers dibeli oleh penggemar selama live stream YouTube.

  • Dalam resource liveChatMessage, properti snippet.type kini ditetapkan ke superStickerEvent untuk menunjukkan bahwa resource berisi informasi tentang Super Sticker. Dalam hal ini, resource juga berisi objek snippet.superStickerDetails, yang berisi informasi tambahan tentang Super Sticker.
  • Dalam resource superChatEvent, boolean snippet.isSuperStickerEvent menunjukkan apakah pesan Super Chat juga merupakan Super Stickers. Jika ya, objek snippet.superStickerMetadata akan berisi detail tambahan tentang Super Sticker.

5 April 2018

Deskripsi metode superChatEvents.list telah diperbarui untuk mencerminkan fakta bahwa respons API tidak lagi berisi fanFundingEvents, yang tidak digunakan lagi pada awal tahun 2017.

3 April 2017

Contoh kode Java baru telah ditambahkan yang menunjukkan cara mencantumkan, menyisipkan, dan menghapus pesan live chat. Contoh ini memanggil metode berikut:

13 Februari 2017

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Metode liveCuepoints.insert telah diperbarui untuk mencerminkan fakta bahwa parameter onBehalfOfContentOwner saat ini diperlukan. Selain itu, deskripsi metode telah diperbarui untuk mencatat bahwa panggilan ke metode tersebut harus diizinkan oleh akun yang terkait dengan Pemilik Konten YouTube.

9 Februari 2017

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Parameter hl baru metode superChatEvents.list memungkinkan Anda menentukan bahwa nilai properti snippet.displayString harus diformat sesuai dengan konvensi bahasa tertentu. Definisi properti tersebut juga telah diperbarui sebagaimana mestinya.

      Nilai parameter harus berupa kode bahasa yang disertakan dalam daftar yang ditampilkan oleh metode i18nLanguages.list. Nilai defaultnya adalah en, yang berarti perilaku defaultnya adalah memformat string tampilan seperti yang akan digunakan dalam bahasa Inggris. Misalnya, secara default, string diformat sebagai $1.00, bukan $1,00.

1 Februari 2017

Update ini berisi perubahan berikut:

  • Resource dan metode baru

    • Resource superChatEvent baru ini merepresentasikan pesan Super Chat yang dibeli oleh penggemar selama live stream YouTube. Dalam streaming live chat YouTube, Super Chat terlihat berbeda dari pesan lain dalam dua cara:

      • Super Chat disoroti dengan warna.
      • Super Chat tetap disematkan di ticker selama jangka waktu tertentu.

      Warna Super Chat, jangka waktu pesan disematkan di ticker, dan panjang pesan maksimum semuanya ditentukan oleh jumlah pembelian. Pusat Bantuan YouTube memiliki informasi selengkapnya tentang Super Chat.

      API ini mendukung metode untuk mencantumkan peristiwa Super Chat untuk live stream channel dalam 30 hari sebelumnya. Metode tersebut juga menampilkan data tentang peristiwa Fan Funding (fanFundingEvents) dari live stream terakhir channel.

  • Pembaruan pada resource dan metode yang ada

    • Properti snippet.type kini mendukung nilai superChatEvent, yang menunjukkan bahwa resource mendeskripsikan Super Chat.

      Selain itu, properti snippet.superChatDetails baru dari resource liveChatMessage dan turunannya berisi informasi tentang acara Super Chat.

    • Properti cdn.resolution resource liveStream kini mendukung nilai 2160p.

  • Error baru dan yang diperbarui

    • API ini mendukung error baru berikut:

      Detail error
      liveBroadcasts.insert, liveBroadcasts.update Metode liveBroadcasts.insert dan liveBroadcasts.update menampilkan error 400 (Bad Request) untuk menunjukkan bahwa resource liveBroadcast yang disisipkan atau diperbarui berisi nilai yang tidak valid untuk properti contentDetails.enableEmbed atau properti contentDetails.projection. Alasan error untuk dua error baru adalah invalidEmbedSetting dan invalidProjection.

12 Januari 2017

Catatan: Ini adalah pengumuman penghentian penggunaan.

Sehubungan dengan rilis fitur Super Chat baru, YouTube tidak lagi menggunakan fitur Fan Funding, dan Fan Funding API akan dinonaktifkan pada 28 Februari 2017. Mulai tanggal tersebut:

11 Agustus 2016

Update ini berisi perubahan berikut:

  • Persyaratan Layanan YouTube API yang baru dipublikasikan ("Persyaratan yang Diperbarui"), yang dibahas secara mendetail di Blog YouTube Engineering and Developers, memberikan serangkaian pembaruan yang lengkap untuk 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 dipatuhi developer.

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

20 Mei 2016

YouTube kini mendukung penyerapan DASH. Oleh karena itu, properti ingestionType resource liveStream mendukung nilai baru dash untuk mengidentifikasi penyerapan streaming ke YouTube menggunakan DASH.

Panduan Mengirimkan Konten Live YouTube melalui DASH yang baru memberikan pedoman untuk menggunakan format Pengiriman DASH guna melakukan streaming data live di YouTube dari encoder. Panduan ini dimaksudkan untuk membantu vendor encoder menambahkan dukungan pengiriman DASH ke produk mereka.

18 April 2016

Update ini berisi perubahan berikut:

  • Pembaruan pada resource dan metode yang ada

    • Pembaruan resource liveStream

      • YouTube kini mendukung streaming dengan resolusi 1440p pada 30 atau 60 frame per detik.

        Selain itu, resource liveStream berisi properti baru untuk menentukan kecepatan frame dan resolusi data video masuk:

        Properti
        cdn.frameRate Kecepatan frame data video masuk. Nilai yang valid adalah 30fps dan 60fps.
        cdn.resolution Resolusi data video masuk. Nilai properti yang valid adalah: 1440p, 1080p, 720p, 480p, 360p, dan 240p.

      • Sesuai dengan pengenalan properti cdn.frameRate dan cdn.resolution resource liveStream, cdn.format resource kini tidak digunakan lagi. Properti cdn.format menentukan resolusi dan kecepatan frame dalam satu nilai.

        Sebaiknya Anda beralih ke kolom yang baru didukung. Sementara itu, cdn.format akan terus berfungsi. Selain itu, permintaan untuk menyisipkan live stream saat ini berhasil selama Anda menentukan nilai untuk properti cdn.format atau properti cdn.frameRate dan cdn.resolution. Jika Anda memberikan nilai untuk ketiga properti, API mungkin akan menampilkan error jika nilainya tidak sesuai.

        Perhatikan bahwa meskipun properti cdn.format tidak digunakan lagi, properti ini kini mendukung dua nilai baru, 1440p dan 1440p_hfr, untuk mencerminkan dukungan API untuk streaming 1440p pada 30 atau 60 frame per detik.

    • Pembaruan resource liveBroadcast
    • Pembaruan resource liveChatMessage

      • Properti snippet.type mendukung dua nilai baru – messageDeletedEvent dan userBannedEvent – yang sesuai dengan properti baru yang dijelaskan dalam poin berikut. Definisi properti snippet.authorChannelId juga telah diperbarui untuk menjelaskan apa yang diidentifikasi oleh nilai properti untuk jenis pesan baru ini.

      • Resource liveChatMessage berisi properti baru berikut:

        Properti
        snippet.messageDeletedDetails Objek ini berisi informasi tentang pesan yang dihapus oleh moderator chat. Objek hanya ada jika nilai properti snippet.type adalah messageDeletedEvent.
        snippet.userBannedDetails Objek ini berisi informasi tentang pengguna yang telah dilarang berpartisipasi dalam chat. Objek ini juga berisi informasi tentang pemblokiran itu sendiri, yaitu apakah pemblokiran bersifat permanen atau sementara. Jika larangan bersifat sementara, salah satu properti objek menentukan durasi larangan.

        Objek ini hanya ada jika nilai properti snippet.type adalah userBannedEvent.

  • Error baru dan yang diperbarui

    • API ini mendukung error baru berikut:

      Detail error
      liveBroadcasts.bind Metode liveBroadcasts.bind menampilkan error 403 (Forbidden) untuk menunjukkan bahwa pengguna telah mengirim terlalu banyak permintaan dalam jangka waktu tertentu. Alasan errornya adalah userRequestsExceedRateLimit.

      Metode liveBroadcasts.insert dan liveBroadcasts.update sudah mendukung error yang sama.
      liveStreams.insert Metode liveStreams.insert mendukung empat error 400 (Bad Request) baru yang mengidentifikasi nilai properti yang tidak valid dalam resource liveStream yang coba disisipkan oleh permintaan. Daftar berikut mengidentifikasi alasan error dan properti yang terkait dengannya:
      liveStreams.insert Metode liveStreams.insert mendukung dua error 400 (Bad Request) baru, yang masing-masing menunjukkan bahwa nilai yang diperlukan tidak ada dalam resource liveStream yang coba disisipkan oleh permintaan. Daftar berikut mengidentifikasi alasan error dan properti yang terkait dengannya:
      Lebih spesifiknya, saat menyisipkan resource liveStream, Anda harus menentukan nilai untuk properti cdn.format atau untuk properti cdn.frameRate dan cdn.resolution.
      • API menampilkan error formatRequired jika Anda tidak menentukan nilai untuk salah satu dari ketiga properti.
      • API menampilkan error frameRateRequired jika Anda menentukan nilai untuk cdn.resolution, tetapi tidak untuk cdn.frameRate.
      • API akan menampilkan error resolutionRequired jika Anda menentukan nilai untuk cdn.frameRate, tetapi tidak untuk cdn.resolution.
      liveStreams.update Metode liveStreams.update menampilkan error 403 (Forbidden) jika permintaan mencoba mengubah nilai salah satu properti yang tidak dapat diubah berikut: reason dalam respons error adalah liveStreamModificationNotAllowed.

18 Desember 2015

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

17 Desember 2015

Update ini berisi perubahan berikut:

  • Resource dan metode baru

    • API ini mendukung beberapa resource baru untuk mendukung fungsi chat untuk live streaming. YouTube mendukung fungsi live chat selama live streaming aktif, dan resource ini serta metodenya mendukung pengambilan pesan chat serta fungsi administratif untuk chat.

      Resource
      liveChatMessage Resource ini mewakili pesan dalam live chat YouTube. YouTube mendukung beberapa jenis pesan, termasuk pesan teks dan acara Fan Funding. Beberapa jenis pesan mengidentifikasi fase tertentu dari chat, seperti awal periode khusus sponsor atau akhir chat. API ini mendukung metode untuk mencantumkan, menyisipkan, dan menghapus pesan live chat.
      liveChatModerators Resource ini mengidentifikasi moderator chat. Moderator dapat melakukan beberapa fungsi administratif, seperti memblokir pengguna dari chat atau menghapus pesan. API ini mendukung metode untuk mencantumkan, menyisipkan, dan menghapus moderator live chat.
      liveChatBans Resource ini mengidentifikasi pengguna yang dilarang memposting pesan ke live chat tertentu. Larangan dapat bersifat sementara atau permanen. API ini mendukung metode untuk menyisipkan dan menghapus larangan live chat.
      fanFundingEvents Referensi ini mewakili peristiwa Fan Funding di channel YouTube. Fan Funding memberikan cara bagi penonton untuk secara sukarela mendukung Kreator YouTube dengan dukungan finansial satu kali.

      Metode fanFundingEvents.list API mencantumkan peristiwa Fan Funding channel. Acara Fan Funding yang dimulai melalui live chat selama live streaming yang dimiliki oleh channel juga akan memicu pesan fanFundingEvent ke live chat siaran.

      Pelajari lebih lanjut Pendanaan dari Penggemar di Pusat Bantuan YouTube.
      sponsors Resource sponsor mengidentifikasi sponsor channel YouTube. Sponsor membayar biaya bulanan ke channel. Badge akan muncul di samping pesan sponsor dalam live chat channel dan sponsor juga dapat berpartisipasi dalam live chat khusus untuk sponsor channel, jika ada.

      Metode sponsors.list API mencantumkan sponsor channel. Saat pengguna mendaftar untuk mensponsori channel selama live streaming yang dimiliki oleh channel tersebut, API juga menambahkan pesan newSponsorEvent ke Live Chat siaran.

      Pelajari lebih lanjut sponsor di Pusat Bantuan YouTube.

  • Pembaruan pada resource dan metode yang ada

    • Resource liveBroadcast berisi properti baru berikut:

      Properti
      snippet.liveChatId ID untuk live chat YouTube siaran. Dengan ID ini, Anda dapat menggunakan metode resource liveChatMessage untuk mengambil, menyisipkan, atau menghapus pesan chat. Anda juga dapat menambahkan atau menghapus moderator chat, memblokir pengguna agar tidak berpartisipasi dalam live chat, atau menghapus pemblokiran yang ada.
      contentDetails.closedCaptionsType Catatan: Properti ini menggantikan properti contentDetails.enableClosedCaptions.

      Properti ini menunjukkan apakah teks tertutup diaktifkan untuk siaran Anda dan, jika ya, jenis teks tertutup yang Anda berikan:
      • closedCaptionsDisabled: Teks tertutup dinonaktifkan untuk live streaming.
      • closedCaptionsHttpPost: Anda akan mengirimkan teks, melalui HTTP POST, ke URL penyerapan yang terkait dengan live stream Anda.
      • closedCaptionsEmbedded: Teks akan dienkode dalam streaming video menggunakan format EIA-608 dan/atau CEA-708.
      contentDetails.enableClosedCaptions Properti ini telah dihentikan sejak 17 Desember 2015. Sebagai gantinya, gunakan properti contentDetails.closedCaptionsType. Untuk klien API yang sudah menggunakan properti ini:
      • Menetapkan nilai properti ke true sama dengan menetapkan properti contentDetails.closedCaptionsType ke closedCaptionsHttpPost.
      • Menetapkan nilai properti ke false setara dengan menetapkan properti contentDetails.closedCaptionsType ke closedCaptionsDisabled.

    • Parameter broadcastType baru dari metode liveBroadcasts.list memungkinkan Anda memfilter respons API untuk menyertakan siaran acara, siaran persisten, atau semua siaran.

      Siaran persisten adalah siaran yang selalu ada dan tidak terkait dengan peristiwa tertentu. Secara khusus, siaran default channel adalah siaran persisten, dan dapat diakses melalui Dasbor Live di YouTube Studio. Siaran lain di channel tersebut adalah siaran acara.

  • Kolom status.healthStatus.configurationIssues[].type resource liveStream melaporkan error status respons berikut:

    Error
    audioTooManyChannels Audio ini memiliki lebih dari dua channel, tetapi hanya satu (mono) atau dua (stereo) channel yang didukung. Perbaiki jumlah channel audio.
    frameRateHigh Frekuensi frame saat ini terlalu tinggi. Tetapkan kecepatan frame ke %(framerate)s fps atau lebih rendah.

  • Tanggal terbit pembaruan dokumentasi sebelumnya telah dikoreksi.

  • Error baru dan yang diperbarui

    • Selain error yang ditentukan untuk resource baru yang tercantum di atas, API mendukung error baru berikut:

      Detail error
      liveBroadcasts.update
      Kode Respons HTTPforbidden (403)
      AlasanclosedCaptionsTypeModificationNotAllowed
      DeskripsiNilai contentDetails.closedCaptionsType hanya dapat diubah jika siaran berstatus created atau ready.
      liveBroadcasts.update
      Kode Respons HTTPinvalidValue (400)
      AlasaninvalidEnableClosedCaptions
      DeskripsiDi resource liveBroadcast, nilai properti contentDetails.enableClosedCaptions tidak kompatibel dengan nilai setelan contentDetails.closedCaptionType. Ubah resource agar hanya menyertakan salah satu dari dua properti, lalu kirim ulang permintaan.

19 Agustus 2015

Update ini berisi perubahan berikut:

  • Referensi dan metode baru

    • Catatan: Dokumentasi untuk resource liveChat dan metodenya bersifat rahasia dan hanya dapat dilihat oleh partner YouTube tertentu.

      Resource liveChat baru berisi komentar yang diposting selama live streaming di YouTube. API ini mendukung dua metode untuk resource ini:

      Metode
      liveChats.list Mencantumkan pesan live chat untuk siaran.
      liveChats.insert Membuat pesan chat baru.

      Pesan live chat hanya dapat diambil dan diposting saat siaran sedang berlangsung.

  • Pembaruan pada resource dan metode yang ada

    • Resource liveStream berisi properti baru berikut:

      Properti
      snippet.isDefaultStream Menunjukkan apakah streaming ini adalah streaming default untuk channel. Streaming default channel ada tanpa batas waktu, tidak memiliki waktu mulai atau berakhir yang terkait, dan tidak dapat dihapus. Lihat definisi properti untuk mengetahui informasi selengkapnya tentang cara kerja aliran data default.
      status.healthStatus Objek ini berisi informasi yang dapat digunakan untuk mengidentifikasi, mendiagnosis, dan menyelesaikan masalah streaming. Objek ini berisi sejumlah properti turunan untuk membantu Anda mengevaluasi kondisi streaming video live.

      Secara khusus, objek status.healthStatus.configurationIssues[] mencantumkan masalah yang memengaruhi streaming video. Dokumen baru, Masalah Konfigurasi untuk Resource LiveStream, mencantumkan semua masalah yang dilaporkan API.
      contentDetails.isReusable Menunjukkan apakah streaming dapat digunakan kembali, yang berarti dapat diikat ke beberapa siaran. Penyiar biasanya menggunakan kembali streaming yang sama untuk banyak siaran yang berbeda jika siaran tersebut terjadi pada waktu yang berbeda.

    • Resource liveBroadcast berisi properti baru berikut:

      Properti
      snippet.isDefaultBroadcast Menunjukkan apakah siaran ini adalah siaran default untuk channel. Jika channel YouTube diaktifkan untuk live streaming, YouTube akan membuat streaming default dan siaran default untuk channel tersebut. Streaming menentukan cara pemilik channel mengirim video live ke YouTube, dan siaran adalah cara penonton dapat melihat streaming default. Lihat definisi properti untuk mengetahui informasi selengkapnya tentang cara kerja siaran default.
      contentDetails.enableLowLatency Menunjukkan apakah siaran ini harus dienkode untuk streaming latensi rendah. Streaming latensi rendah dapat mengurangi jumlah waktu yang diperlukan agar video dapat dilihat oleh pengguna yang menonton siaran, meskipun hal ini juga dapat memengaruhi resolusi bagi penonton streaming.
      statistics.totalChatCount Jumlah total pesan live chat yang terkait dengan siaran. Properti dan nilainya ada jika siaran dapat dilihat oleh pengguna dan fitur live chat diaktifkan. Perhatikan bahwa properti ini tidak akan menentukan nilai setelah siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah pesan chat untuk video yang diarsipkan dari live streaming yang telah selesai.

  • Error baru dan yang diperbarui

    • Selain error yang ditentukan untuk resource liveChat baru, API mendukung error baru berikut:

      Detail error
      liveStreams.update
      Kode Respons HTTPforbidden (403)
      AlasanliveStreamModificationNotAllowed
      DeskripsiAPI tidak mengizinkan Anda mengubah streaming yang dapat digunakan kembali menjadi tidak dapat digunakan kembali, atau sebaliknya. Untuk mengetahui informasi selengkapnya, lihat Memahami Siaran dan Streaming

21 Mei 2015

Update ini berisi perubahan berikut:

  • YouTube kini mendukung streaming video live pada 60 frame per detik (fps), yang berarti pemutaran yang lebih lancar untuk game dan video aksi cepat lainnya. Saat Anda memulai live stream di YouTube dengan kecepatan 60 fps, YouTube juga menyediakan streaming dalam kecepatan 30 fps di perangkat yang belum mendukung tampilan kecepatan frame tinggi.

    Properti cdn.format resource liveStream mendukung dua nilai baru untuk fitur ini: 720p_hfr dan 1080p_hfr.

    Lihat Blog Kreator YouTube untuk mengetahui informasi selengkapnya tentang fitur ini.

21 Agustus 2014

Update ini berisi perubahan berikut:

  • Definisi parameter walltime metode liveBroadcasts.control telah diperbarui untuk mencatat bahwa nilai properti ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

  • API ini sekarang mendukung error berikut:

    Jenis error Detail error Deskripsi
    insufficientPermissions liveStreamingNotEnabled Semua metode untuk resource liveBroadcast dan liveStream menampilkan error ini jika pengguna yang mengizinkan permintaan API belum diaktifkan untuk melakukan streaming video live di YouTube. Detail yang menjelaskan alasan pengguna tidak dapat melakukan streaming video live mungkin tersedia di setelan channel pengguna di https://www.youtube.com/features.
    rateLimitExceeded userRequestsExceedRateLimit Metode liveBroadcasts.insert dan liveStreams.insert menampilkan error ini untuk menunjukkan bahwa pengguna telah mengirim terlalu banyak permintaan dalam jangka waktu tertentu.

2 Mei 2014

Update ini berisi perubahan berikut:

  • Deskripsi resource liveStream dan metode liveBroadcasts.bind telah diperbarui untuk mencatat bahwa siaran hanya dapat terikat ke satu streaming video, tetapi streaming video dapat terikat ke lebih dari satu siaran. Perubahan ini semata-mata merupakan koreksi pada dokumentasi; fungsi API yang mendasarinya tidak berubah.

  • Properti contentDetails.monitorStream.enableMonitorStream resource liveBroadcast telah diperbarui untuk menjelaskan bahwa jika nilai properti adalah true, Anda harus mentransisikan siaran ke status testing sebelum dapat mentransisikannya ke status live. (Jika nilai properti adalah false, siaran Anda tidak dapat memiliki status testing, sehingga Anda dapat langsung mentransisikan siaran ke status live.

  • Properti settings.offsetTimeMs resource liveCuepoint telah diperbarui untuk mencatat bahwa Anda tidak boleh menentukan nilai untuk properti tersebut jika siaran Anda tidak memiliki streaming monitor.

  • Semua metode untuk resource liveBroadcast dan liveStream kini mendukung parameter onBehalfOfContentOwner dan onBehalfOfContentOwnerChannel. Parameter ini memungkinkan Anda menggunakan kredensial otorisasi yang sama untuk menyelesaikan permintaan API untuk berbagai channel yang terkait dengan pemilik konten yang sama.

  • Dokumentasi metode liveCuepoints.insert telah diperbarui untuk mencatat bahwa Anda dapat menetapkan nilai untuk properti settings.walltime saat memanggil metode tersebut.

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

  • API kini mendukung error berikut:

    Jenis error Detail error Deskripsi
    insufficientPermissions livePermissionBlocked Metode liveBroadcasts.insert, liveBroadcasts.transition, dan liveStreams.insert menampilkan error ini jika pengguna yang mengizinkan permintaan tidak dapat melakukan streaming video live di YouTube. Detail yang menjelaskan alasan pengguna tidak dapat melakukan streaming video live mungkin tersedia di setelan channel pengguna di https://www.youtube.com/features.

  • Error invalidScheduledStartTime metode liveBroadcasts.insert telah diperbarui untuk mengklarifikasi bahwa waktu mulai terjadwal harus cukup dekat dengan tanggal saat ini sehingga siaran dapat dijadwalkan dengan andal pada waktu tersebut.

13 Desember 2013

Update ini berisi perubahan berikut:

  • Properti status.recordingStatus baru resource liveBroadcast mengidentifikasi status siaran saat ini.

  • Properti contentDetails.enableClosedCaptions baru resource liveBroadcast menunjukkan apakah teks tertutup dapat di-ingest untuk siaran. Nilai properti dapat ditetapkan saat Anda menyisipkan atau memperbarui siaran, tetapi tidak dapat diperbarui setelah siaran berada dalam status testing atau live. Jika Anda menetapkan properti ini ke true, resource liveStream yang terikat ke siaran akan menentukan URL penyerapan yang akan digunakan untuk teks tertutup siaran.

  • Properti liveBroadcast resource snippet.scheduledEndTime kini mendukung siaran yang dijadwalkan untuk berlanjut tanpa batas waktu. Dengan perubahan ini, properti tidak lagi diperlukan dalam permintaan liveBroadcasts.insert dan liveBroadcasts.update.

    Jika Anda mengambil resource liveBroadcast yang tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk terus berlanjut tanpa batas waktu. Demikian pula, jika Anda memanggil metode liveBroadcasts.insert atau liveBroadcasts.update dan tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk dilanjutkan tanpa batas waktu.

  • Properti contentDetails.recordFromStart resource liveBroadcast, yang sudah memiliki nilai default true, kini hanya dapat ditetapkan ke false jika channel penyiaran diizinkan untuk menonaktifkan rekaman untuk live streaming.

    Jika channel Anda tidak memiliki izin untuk menonaktifkan rekaman, dan Anda mencoba menyisipkan siaran dengan properti recordFromStart yang ditetapkan ke false, API akan menampilkan error Forbidden. Selain itu, jika channel Anda tidak memiliki izin tersebut dan Anda mencoba memperbarui siaran untuk menetapkan properti recordFromStart ke false, API akan menampilkan error modificationNotAllowed.

  • Resource liveBroadcast tidak lagi berisi properti enableArchive, yang telah disebutkan dalam deskripsi properti contentDetails.enableDvr dan contentDetails.enableEmbed.

  • Daftar nilai valid untuk properti liveBroadcast resource status.lifeCycleStatus telah diperbarui untuk menyertakan deskripsi setiap status.

  • Properti settings.walltime baru resource liveCuepoint menentukan tanggal dan waktu saat titik tanda harus disisipkan. API akan menampilkan error jika permintaan mencoba menyisipkan titik cue yang menentukan nilai untuk properti ini dan untuk properti settings.offsetTimeMs.

  • Objek contentDetails baru dalam resource liveStream berisi informasi tentang streaming. Saat ini, satu-satunya properti objek adalah contentDetails.closedCaptionsIngestionUrl, yang menentukan URL penyerapan untuk teks tertutup yang terkait dengan streaming video.

  • Daftar nilai yang valid untuk properti status.streamStatus resource liveStream telah diperbarui untuk menyertakan deskripsi setiap status.

  • Parameter walltime baru dari metode liveBroadcasts.control memungkinkan Anda menentukan tanggal dan waktu terjadinya perubahan slate. API akan menampilkan error jika permintaan menentukan nilai untuk parameter ini dan untuk parameter offsetTimeMs.

  • Dalam respons API terhadap permintaan liveBroadcasts.list, nilai properti kind telah berubah dari youtube#liveBroadcastList menjadi youtube#liveBroadcastListResponse.

  • Dalam respons API terhadap permintaan liveStreams.list, nilai properti kind telah berubah dari youtube#liveStreamList menjadi youtube#liveStreamListResponse.

  • Properti eventId tidak digunakan lagi dari liveBroadcastListResponse dan liveStreamListResponse.

  • API ini mendukung error baru berikut:

    Jenis error Detail error Deskripsi
    invalidValue conflictingTimeFields Metode liveBroadcasts.control menampilkan error ini jika permintaan Anda menentukan nilai untuk parameter offsetTimeMs dan walltime. Permintaan dapat menghilangkan kedua parameter atau menentukan nilai untuk salah satu dari dua parameter tersebut.
    invalidValue invalidWalltime Metode liveBroadcasts.control menampilkan error ini jika nilai parameter walltime tidak valid.
    forbidden enableClosedCaptionsModificationNotAllowed Metode liveBroadcasts.update menampilkan error ini jika Anda mencoba memperbarui nilai contentDetails.enableClosedCaptions dan status siaran bukan created atau ready.
    invalidValue conflictingTimeFields Metode liveCuepoints.insert menampilkan error ini jika permintaan Anda menentukan nilai untuk properti settings.offsetTimeMs dan settings.walltime. Permintaan dapat menghilangkan kedua properti atau menentukan nilai untuk salah satu dari kedua properti tersebut.

    Selain itu, metode liveStreams.update tidak lagi mendukung error cdnRequired yang serupa dengan yang didukung oleh metode liveStreams.insert.

10 Mei 2013

Update ini berisi perubahan berikut:

2 Mei 2013

Update ini berisi perubahan berikut:

27 Maret 2013

Update ini berisi perubahan berikut:

  • Properti berikut telah berubah di resource liveBroadcast:

    • Properti startWithSlateCuepoint telah diganti namanya menjadi startWithSlate.
    • Properti enableArchive telah diganti namanya menjadi recordFromStart.
    • Objek slateSettings tidak digunakan lagi dan dihapus dari dokumentasi. Pesan error yang terkait dengan objek slateSettings atau propertinya juga telah dihapus. Terakhir, bagian "Menampilkan Slate" dalam panduan Memulai telah dihapus.

  • API tidak lagi mendukung kemampuan untuk menyisipkan layar penuh dalam streaming menggunakan metode liveCuepoints.insert. Dokumen berikut telah diperbarui untuk mencerminkan perubahan ini:

    • Halaman indeks, panduan Memulai, dan tutorial Proses siaran tidak lagi menyebutkan fungsi ini.

    • Properti settings.cueType resource liveCuepoint tidak lagi mendukung slate sebagai nilai properti. (Satu-satunya nilai yang didukung adalah ad.

    • Properti settings.eventState resource liveCuepoint telah dihentikan dan dihapus dari dokumentasi.

18 Maret 2013

Update ini berisi perubahan berikut:

  • Semua pesan error API telah diperbarui untuk menjelaskan kemungkinan error dengan lebih jelas dan, jika memungkinkan, menawarkan panduan tentang cara memperbaikinya.

  • API kini dapat menampilkan beberapa error baru. Daftar di bawah mengidentifikasi error dan metode API yang mungkin menampilkan error tersebut:

    • liveBroadcasts.insert – Waktu berakhir terjadwal siaran harus setelah waktu mulai terjadwalnya.
    • liveBroadcasts.insert – Siaran menentukan status privasi yang tidak valid.
    • liveBroadcasts.update – Resource tidak berisi atau tidak menetapkan nilai untuk properti contentDetails.enableArchive.
    • liveBroadcasts.update – Resource tidak berisi atau tidak menetapkan nilai untuk properti contentDetails.enableContentEncryption.
    • liveBroadcasts.update – Resource tidak berisi atau tidak menetapkan nilai untuk properti contentDetails.enableDvr.
    • liveStreams.insert – Panjang judul cuplikan harus antara 1 dan 128 karakter.
    • liveStreams.update – Resource tidak berisi atau tidak menetapkan nilai untuk properti snippet.title.

  • Dokumentasi resource liveStream telah diperbarui untuk menunjukkan bahwa multicast dan WebM bukan metode penyerapan yang didukung seperti yang ditunjukkan sebelumnya. Daftar format untuk properti cdn.format telah diperbarui, dan objek cdn.multicastIngestionInfo serta properti turunannya telah dihapus dari dokumentasi resource. Selain itu, http telah dihapus dari daftar nilai cdn.ingestionType yang didukung.