Halaman ini mencantumkan perubahan YouTube Live Streaming API dan update dokumentasi. Berlangganan log perubahan ini. 
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 Stiker tertentu dalam
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 kini mendukung cara baru untuk menyisipkan iklan ke siaran langsung. 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 cue iklan. Cuepoint dapat disisipkan secara bersamaan untuk semua penonton atau waktu cuepoint dapat bervariasi dari penonton ke penonton. Strategi terakhir memungkinkan YouTube menjadwalkan titik isyarat dengan kecepatan yang lebih tinggi sehingga penonton dapat menerima titik isyarat 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 mencerminkan perubahan API berikut untuk mendukung fitur ini:
- Resource
liveBroadcastkini berisi objekmonetizationDetails. Kolom objek menunjukkan apakah penyisipan iklan otomatis diaktifkan untuk siaran dan menentukan informasi tambahan untuk menjadwalkan titik pemicu. - Parameter
partmetodeliveBroadcast.listmendukung nilaimonetizationDetails. - Metode
updatedapat digunakan untuk menjeda penyisipan iklan mid-roll selama jangka waktu tertentu untuk siaran langsung. 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.updatetidak lagi memerlukan nilai untuk ditentukan bagi kolom berikut:snippet.titlestatus.privacyStatus
Jika kolom ini tidak disertakan dalam permintaan, kolom tersebut tidak akan berubah.
1 November 2022
-
Metode
liveBroadcasts.cuepointbaru memungkinkan pemilik channel yang menjalankan siaran live di YouTube menyisipkan titik cue ke dalam siaran tersebut, yang dapat memicu jeda iklan. Metode ini menggantikan metodeliveCuepoints.insert, yang hanya memungkinkan partner konten YouTube menyisipkan titik cue ke dalam siaran live.Beberapa panduan telah diperbarui untuk mencerminkan ketersediaan metode baru ini.
-
Catatan: Ini adalah pengumuman penghentian penggunaan.
Metode
liveCuepoints.insertkini tidak digunakan lagi. Dukungan untuk metodeliveCuepoints.insertakan dihapus pada atau setelah 1 Mei 2023. Pengguna API harus mengupdate aplikasi mereka untuk memanggil metodeliveBroadcasts.cuepointsebagai gantinya. -
Dokumentasi untuk metode
liveBroadcasts.controltelah dihapus. A pemberitahuan penghentian penggunaan untuk metode tersebut diposting pada September 2020.
1 Oktober 2022
Update ini berisi perubahan berikut:
-
Metode
liveBroadcasts.updatetidak lagi memerlukan nilai untuk ditentukan bagi kolom ini:contentDetails.enableContentEncryptioncontentDetails.enableDvrcontentDetails.enableEmbedcontentDetails.recordFromStartcontentDetails.startWithSlate
Jika kolom ini tidak disertakan dalam permintaan, kolom tersebut tidak akan berubah.
-
Menghapus dokumentasi untuk kolom
liveBroadcastyang tidak digunakan lagi:contentDetails.enableContentEncryptioncontentDetails.startWithSlate
1 April 2022
Update ini berisi perubahan berikut:
-
Properti
snippet.typekini mendukung dua nilai baru:membershipGiftingEventgiftMembershipReceivedEvent
-
Properti
snippet.membershipGiftingDetailsbaru dan turunannya di resourceliveChatMessageberisi informasi tentang acara Pemberian Hadiah Langganan. Demikian pula, propertisnippet.giftMembershipReceivedDetailsbaru dan turunannya berisi informasi tentang peristiwa Menerima Langganan Hadiah.
15 September 2021
Update ini berisi perubahan berikut:
-
Properti
snippet.typekini mendukung dua nilai baru:newSponsorEventmemberMilestoneChatEvent
-
Properti
snippet.memberMilestoneChatDetailsbaru dan turunannya di resourceliveChatMessageberisi informasi tentang peristiwa Chat Pencapaian Pelanggan. Demikian pula, propertisnippet.newSponsorDetailsbaru 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.madeForKidsresourceliveBroadcasttelah diperbarui untuk memperjelas bahwa properti bersifat hanya baca. Perubahan ini tidak mencerminkan perubahan pada fungsi API.Untuk menetapkan siaran live sebagai ditujukan untuk anak-anak, tetapkan properti
status.selfDeclaredMadeForKidsketruesaat memanggil metodeliveBroadcasts.insertuntuk membuat siaran. -
Catatan: Perubahan ini mencakup pengumuman penghentian penggunaan dan pembaruan pada pengumuman penghentian penggunaan sebelumnya.
Metode
liveBroadcasts.controltidak akan digunakan lagi pada atau setelah 1 Oktober 2020. Setelah tanggal tersebut, semua panggilan ke metode ini akan menampilkan error terlarang (403), dan metode ini akan dihapus sepenuhnya nanti. Klien tetap dapat menerapkan slating 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. Dengan demikian, fitur yang disertakan dalam pengumuman penghentian penggunaan tersebut dan metode
liveBroadcasts.controlakan 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 Menyampaikan Konten YouTube Live melalui HLS telah diperbarui dengan beberapa perubahan:
- Durasi yang direkomendasikan untuk Segmen Media telah diperbarui menjadi satu hingga empat detik.
- Bagian baru menjelaskan cara mendapatkan URL Penyerapan HLS dari YouTube Creator Studio.
-
Petunjuk untuk memformat nilai parameter
filetelah dipindahkan ke bagian Menyelesaikan URL Transfer HLS yang baru. Petunjuk ini berlaku terlepas dari apakah URL penyerapan HLS diperoleh dari YouTube API atau YouTube Creator Studio.
Selain itu, perbandingan protokol penyerapan baru mencantumkan protokol penyerapan yang didukung YouTube, codec yang didukung untuk setiap protokol, dan informasi tambahan terkait kasus penggunaan yang sesuai untuk setiap protokol.
16 April 2020
Pembaruan ini mencakup properti baru dan pengumuman penghentian:
-
Resource
liveBroadcastkini mendukung properticontentDetails.enableAutoStop. Properti ini menunjukkan apakah siaran harus berhenti secara otomatis sekitar satu menit setelah pemilik channel menghentikan streaming video di aliran video 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.enableAutoStartataucontentDetails.enableAutoStopketrue. -
Catatan: Ini adalah pengumuman penghentian penggunaan. Perubahan ini akan berlaku pada atau setelah 1 September 2020. Tanggal sebenarnya saat perubahan berlaku disebut di bawah sebagai tanggal penghentian penggunaan.
Pembaruan ini menjelaskan perubahan yang berpotensi menyebabkan gangguan. Hal ini memengaruhi aplikasi klien API yang menggunakan resource
liveStreamdanliveBroadcastdefault 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 kondisi berikut benar:
- Fungsi ini memeriksa nilai properti
isDefaultBroadcastliveBroadcastresource. Properti ini tidak akan ditampilkan setelah tanggal penghentian penggunaan. - Fungsi ini memeriksa nilai properti
isDefaultStreamliveStreamresource. Properti ini tidak akan ditampilkan setelah tanggal penghentian penggunaan. - Metode ini memanggil
metode
liveBroadcasts.listdan menetapkan nilai parameterbroadcastTypekepersistentatauall. Parameter ini akan dihentikan sebagai bagian dari perubahan ini. Mulai tanggal penghentian:- Jika nilai parameter
broadcastTypeadalahpersistent, maka metodeliveBroadcasts.listtidak akan menampilkan hasil apa pun. - Jika nilai parameter
broadcastTypeadalahall, maka metodeliveBroadcasts.listtidak akan menampilkan siaran persisten yang ada sebelum waktu tersebut.
- Jika nilai parameter
Sebagai latar belakang, selama beberapa tahun terakhir, YouTube telah otomatis membuat stream default dan siaran default untuk channel saat channel tersebut diaktifkan untuk live streaming. Aliran default ada tanpa batas waktu, tidak memiliki waktu mulai atau berakhir yang terkait dengannya, dan tidak dapat dihapus. Demikian pula, siaran default dianggap persisten. Dimensi ini selalu ada dan tidak terikat pada peristiwa tertentu.
Mulai tanggal penghentian:
- YouTube tidak akan lagi membuat streaming dan siaran default. Alih-alih mengandalkan
resource default, klien API harus dapat membuat dan mengelola
resource
liveBroadcastdanliveStreamserta mengikat resource tersebut bersama-sama. - Jika siaran default dan streaming default channel sedang aktif, yang berarti channel menggunakannya untuk siaran langsung pada saat penghentian penggunaan 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, setelah penghentian penggunaan berlaku, YouTube akan mengabaikan upaya untuk menggunakan resource tersebut untuk menyiarkan video.
Jika aplikasi Anda terpengaruh, lihat dokumen berikut, yang akan membantu Anda memperbarui 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.
- Fungsi ini memeriksa nilai properti
31 Maret 2020
Catatan: Ini adalah pengumuman penghentian penggunaan.
Resource sponsor dan
metode sponsors.list telah
dihentikan penggunaannya 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 Menyampaikan Konten YouTube Live melalui HLS telah diperbarui untuk
memperjelas 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 mengirimkan
permintaan DELETE.
January 10, 2020
API 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.
-
Referensi
liveBroadcastmendukung dua properti baru untuk memungkinkan kreator dan penonton konten mengidentifikasi konten "dibuat untuk anak-anak":-
Properti
selfDeclaredMadeForKidsmemungkinkan kreator konten menentukan apakah siaran langsung adalah konten yang ditujukan untuk anak-anak. Properti ini dapat ditetapkan saat membuat siaran melalui metodeliveBroadcasts.insert. Perhatikan bahwa properti ini hanya disertakan dalam respons API yang berisi resourceliveBroadcastjika pemilik channel mengizinkan permintaan API. -
Properti
madeForKidsmemungkinkan setiap pengguna API mengambil status "dibuat untuk anak-anak" dari siaran. Misalnya, status dapat ditentukan berdasarkan nilai propertiselfDeclaredMadeForKids. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang cara menetapkan penonton untuk channel, video, atau siaran Anda.
-
Properti
-
Di YouTube Data API, resource
channeljuga mendukung propertiselfDeclaredMadeForKidsdanmadeForKidsbaru.
Kami juga telah memperbarui Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer. Lihat Histori Revisi - Persyaratan Layanan untuk Layanan YouTube API untuk mengetahui informasi selengkapnya. Perubahan pada Persyaratan Layanan untuk Layanan API YouTube dan Kebijakan Developer akan berlaku pada 10 Januari 2020 Waktu Pasifik.
20 Agustus 2019
Bagian Persyaratan dalam panduan Mengirimkan Konten YouTube Live melalui HLS telah diperbarui dengan dua perubahan:
- Dokumen ini menjelaskan bahwa praktik terbaiknya adalah menyertakan segmen yang telah dikonfirmasi dan segmen yang belum diselesaikan di setiap Playlist Media. Praktik ini membuat segmen cenderung tidak dilewati jika Daftar 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 di-ingest ke YouTube menggunakan HLS.
Panduan Menyampaikan Konten YouTube Live melalui HLS yang baru memberikan pedoman untuk menggunakan HLS guna menstreaming 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 APIs Explorer. Lihat dokumentasi metode
liveBroadcasts.listuntuk mengetahui contohnya. Sekarang 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 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
liveBroadcasts.listuntuk 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 tersebut sudah terisi. 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 kini dapat berisi informasi tentang Super Stickers. Super Stickers adalah jenis pesan Super Chat yang menampilkan gambar. Seperti Super Chat lainnya, pesan Super Sticker dibeli oleh penggemar selama live stream YouTube.
- Di resource
liveChatMessage, propertisnippet.typekini ditetapkan kesuperStickerEventuntuk menunjukkan bahwa resource berisi informasi tentang Stiker Super. Dalam hal ini, resource juga berisi objeksnippet.superStickerDetails, yang berisi informasi tambahan tentang Super Stiker. - Dalam resource
superChatEvent, booleansnippet.isSuperStickerEventmenunjukkan apakah pesan Super Chat juga merupakan Super Sticker. Jika ya, objeksnippet.superStickerMetadataberisi detail tambahan tentang Super Stiker.
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 chat live. Contoh memanggil metode berikut:
13 Februari 2017
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Metode
liveCuepoints.inserttelah diperbarui untuk mencerminkan fakta bahwa parameteronBehalfOfContentOwnersaat ini diperlukan. Selain itu, deskripsi metode telah diperbarui untuk mencatat bahwa panggilan ke metode tersebut harus diotorisasi oleh akun yang terkait dengan Pemilik Konten YouTube.
-
9 Februari 2017
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Parameter
hlbaru metodesuperChatEvents.listmemungkinkan Anda menentukan bahwa nilai propertisnippet.displayStringharus 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 adalahen, yang berarti bahwa perilaku defaultnya adalah memformat string tampilan sebagaimana 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
superChatEventbaru merepresentasikan pesan Super Chat yang dibeli oleh penggemar selama live stream YouTube. Dalam streaming live chat YouTube, Super Chat lebih terlihat dari pesan lainnya karena dua hal:- Super Chat ditandai dengan warna.
- Super Chat akan terus disematkan di ticker selama jangka waktu yang ditetapkan.
Warna Super Chat, jangka waktu Super Chat tetap disematkan di ticker, dan panjang maksimum pesan 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.typekini mendukung nilaisuperChatEvent, yang menunjukkan bahwa resource menjelaskan Super Chat.Selain itu, properti
snippet.superChatDetailsbaru dan turunannya di resourceliveChatMessageberisi informasi tentang peristiwa Super Chat. -
Properti
cdn.resolutionresourceliveStreamkini mendukung nilai2160p.
-
-
Error baru dan yang diperbarui
-
API ini mendukung error baru berikut:
Detail error liveBroadcasts.insert,liveBroadcasts.updateMetode liveBroadcasts.insertdanliveBroadcasts.updatemenampilkan error400(Bad Request) untuk menunjukkan bahwa resourceliveBroadcastyang disisipkan atau diperbarui berisi nilai yang tidak valid untuk properticontentDetails.enableEmbedatau properticontentDetails.projection. Alasan error untuk dua error baru tersebut adalahinvalidEmbedSettingdaninvalidProjection.
-
12 Januari 2017
Catatan: Ini adalah pengumuman penghentian penggunaan.
Sehubungan dengan rilis fitur Super Chat baru, YouTube telah menghentikan penggunaan fitur Fan Funding, dan Fan Funding API akan dinonaktifkan pada 28 Februari 2017. Mulai tanggal tersebut:
- Metode
liveChatMessages.listtidak akan lagi menampilkan pesan dengansnippet.typefanFundingEvent. Demikian pula, resourceliveChatMessagetidak akan lagi berisi objeksnippet.fanFundingEventDetails. - Metode
fanFundingEvents.listtidak akan lagi menampilkan data.
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 Engineering dan Developer YouTube, memberikan serangkaian pembaruan yang kaya 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 dipatuhi developer.
Kumpulan lengkap dokumen baru dijelaskan dalam histori revisi untuk Persyaratan yang Diperbarui. Selain itu, perubahan mendatang pada Persyaratan yang Diperbarui atau pada 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 streaming yang di-ingest ke YouTube menggunakan DASH.
Panduan Mengirimkan Konten YouTube Live melalui DASH yang baru memberikan pedoman untuk menggunakan format Pengiriman DASH guna melakukan streaming data live di YouTube dari encoder. Tujuannya adalah 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
liveStreamberisi properti baru untuk menentukan kecepatan frame dan resolusi data video masuk:Properti cdn.frameRateKecepatan frame data video masuk. Nilai yang valid adalah 30fpsdan60fps.cdn.resolutionResolusi data video masuk. Nilai properti yang valid adalah: 1440p,1080p,720p,480p,360p, dan240p. -
Sesuai dengan pengenalan properti
cdn.frameRatedancdn.resolutionresourceliveStream,cdn.formatresource kini tidak digunakan lagi. Properticdn.formatmenentukan resolusi dan kecepatan frame dalam satu nilai.Sebaiknya Anda beralih ke kolom yang baru didukung. Sementara itu,
cdn.formattetap berfungsi. Selain itu, permintaan untuk menyisipkan live stream saat ini berhasil selama Anda menentukan nilai untuk properticdn.formatatau properticdn.frameRatedancdn.resolution. Jika Anda memberikan nilai untuk ketiga properti, API dapat menampilkan error jika nilai tidak sesuai.Perhatikan bahwa meskipun properti
cdn.formattidak digunakan lagi, properti ini kini mendukung dua nilai baru,1440pdan1440p_hfr, untuk mencerminkan dukungan API untuk streaming 1440p pada 30 atau 60 frame per detik.
-
- Pembaruan resource
liveBroadcast-
Resource
liveBroadcastberisi properti baru berikut:Properti contentDetails.boundStreamLastUpdateTimeMsTanggal dan waktu saat live stream yang dirujuk oleh properti contentDetails.boundStreamIdsiaran terakhir diperbarui.contentDetails.projectionFormat proyeksi siaran. Nilai default properti adalah rectangular. Nilai yang valid untuk properti ini adalah360danrectangular. -
Definisi properti
statistics.totalChatCountresourceliveBroadcasttelah diperbarui untuk mencatat bahwa nilai properti hanya muncul jika siaran memiliki setidaknya satu pesan chat.
-
- Pembaruan resource
liveChatMessage-
Properti
snippet.typemendukung dua nilai baru –messageDeletedEventdanuserBannedEvent– yang sesuai dengan properti baru yang dijelaskan dalam poin-poin berikut. Definisi propertisnippet.authorChannelIdjuga telah diperbarui untuk menjelaskan apa yang diidentifikasi oleh nilai properti untuk jenis pesan baru ini. -
Resource
liveChatMessageberisi properti baru berikut:Properti snippet.messageDeletedDetailsObjek ini berisi informasi tentang pesan yang dihapus oleh moderator chat. Objek hanya ada jika nilai properti snippet.typeadalahmessageDeletedEvent.snippet.userBannedDetailsObjek ini berisi informasi tentang pengguna yang telah dilarang berpartisipasi dalam chat. Objek ini juga berisi informasi tentang larangan itu sendiri, yaitu apakah larangan tersebut bersifat permanen atau sementara. Jika larangan bersifat sementara, salah satu properti objek menentukan durasi larangan.
Objek ini hanya ada jika nilai propertisnippet.typeadalahuserBannedEvent.
-
- Pembaruan resource
-
Error baru dan yang diperbarui
-
API ini mendukung error baru berikut:
Detail error liveBroadcasts.bindMetode liveBroadcasts.bindmenampilkan error403(Forbidden) untuk menunjukkan bahwa pengguna telah mengirim terlalu banyak permintaan dalam jangka waktu tertentu. Alasan errornya adalahuserRequestsExceedRateLimit.
MetodeliveBroadcasts.insertdanliveBroadcasts.updatesudah mendukung error yang sama.liveStreams.insertMetode liveStreams.insertmendukung empat error400(Bad Request) baru yang mengidentifikasi nilai properti tidak valid dalam resourceliveStreamyang coba disisipkan oleh permintaan. Daftar berikut mengidentifikasi alasan error dan properti yang terkait dengannya:
invalidFormat:cdn.formatinvalidFrameRate:cdn.frameRateinvalidIngestionType:cdn.ingestionTypeinvalidResolution:cdn.resolution
liveStreams.insertMetode liveStreams.insertmendukung dua error400(Bad Request) baru, yang masing-masing menunjukkan bahwa nilai yang diperlukan tidak ada dalam resourceliveStreamyang coba disisipkan oleh permintaan. Daftar berikut mengidentifikasi alasan error dan properti yang terkait dengannya:
frameRateRequired:cdn.frameRateresolutionRequired:cdn.resolution
liveStream, Anda harus menentukan nilai untuk properticdn.formatatau untuk properticdn.frameRatedancdn.resolution.
- API menampilkan error
formatRequiredjika Anda tidak menentukan nilai untuk salah satu dari tiga properti. - API menampilkan error
frameRateRequiredjika Anda menentukan nilai untukcdn.resolution, tetapi tidak untukcdn.frameRate. - API menampilkan error
resolutionRequiredjika Anda menentukan nilai untukcdn.frameRate, tetapi tidak untukcdn.resolution.
liveStreams.updateMetode liveStreams.updatemenampilkan error403(Forbidden) jika permintaan mencoba mengubah nilai salah satu properti yang tidak dapat diubah berikut:cdn.formatcdn.frameRatecdn.ingestionTypecdn.resolution
reasondalam respons error adalahliveStreamModificationNotAllowed.
-
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 dalam Persyaratan Layanan YouTube API kami.
17 Desember 2015
Update ini berisi perubahan berikut:
-
Resource dan metode baru
-
API ini mendukung beberapa resource baru untuk mendukung fungsi chat untuk siaran langsung. YouTube mendukung fungsi live chat selama siaran langsung aktif, dan resource ini serta metodenya mendukung pengambilan pesan chat serta fungsi administratif untuk chat.
Resource liveChatMessageResource ini merepresentasikan pesan dalam live chat YouTube. YouTube mendukung beberapa jenis pesan, termasuk pesan teks dan acara Fan Funding. Beberapa jenis pesan mengidentifikasi fase tertentu dalam chat, seperti awal periode khusus sponsor atau akhir chat. API ini mendukung metode untuk mencantumkan, menyisipkan, dan menghapus pesan live chat. liveChatModeratorsResource ini mengidentifikasi moderator chat. Moderator dapat melakukan beberapa fungsi administratif, seperti melarang pengguna dari chat atau menghapus pesan. API ini mendukung metode untuk mencantumkan, menyisipkan, dan menghapus moderator live chat. liveChatBansResource 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. fanFundingEventsResource ini merepresentasikan acara Fan Funding di channel YouTube. Fan Funding memberi penonton cara untuk mendukung Kreator YouTube secara sukarela dengan dukungan finansial satu kali.
MetodefanFundingEvents.listAPI mencantumkan peristiwa Fan Funding channel. Acara Pendanaan dari Penggemar yang dimulai melalui live chat selama siaran live yang dimiliki oleh channel juga memicu pesanfanFundingEventke live chat siaran.
Pelajari lebih lanjut Pendanaan dari Penggemar di Pusat Bantuan YouTube.sponsorsResource sponsormengidentifikasi sponsor channel YouTube. Sponsor membayar biaya bulanan kepada channel. Badge akan muncul di samping pesan sponsor di live chat channel dan sponsor juga dapat berpartisipasi dalam live chat khusus sponsor channel, jika ada.
Metodesponsors.listAPI mencantumkan sponsor channel. Saat pengguna mendaftar untuk mensponsori channel selama siaran live yang dimiliki oleh channel tersebut, API juga menambahkan pesannewSponsorEventke live chat siaran.
Pelajari lebih lanjut sponsor di Pusat Bantuan YouTube.
-
-
Pembaruan pada resource dan metode yang ada
-
Resource
liveBroadcastberisi properti baru berikut:Properti snippet.liveChatIdID untuk live chat YouTube siaran. Dengan ID ini, Anda dapat menggunakan metode resource liveChatMessageuntuk mengambil, menyisipkan, atau menghapus pesan chat. Anda juga dapat menambahkan atau menghapus moderator chat, melarang pengguna berpartisipasi dalam live chat, atau menghapus larangan yang ada.contentDetails.closedCaptionsTypeCatatan: 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 siaran langsung.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.enableClosedCaptionsProperti ini sudah tidak digunakan lagi sejak 17 Desember 2015. Sebagai gantinya, gunakan properti contentDetails.closedCaptionsType. Untuk klien API yang sudah menggunakan properti ini:- Menetapkan nilai properti ke
truesetara dengan menetapkan properticontentDetails.closedCaptionsTypekeclosedCaptionsHttpPost. - Menetapkan nilai properti ke
falsesetara dengan menetapkan properticontentDetails.closedCaptionsTypekeclosedCaptionsDisabled.
-
Parameter
broadcastTypebaru pada metodeliveBroadcasts.listmemungkinkan Anda memfilter respons API untuk menyertakan siaran peristiwa, siaran persisten, atau semua siaran.Siaran tetap adalah siaran yang selalu ada dan tidak terikat pada peristiwa tertentu. Secara khusus, siaran default channel adalah siaran persisten, dan dapat diakses melalui Dasbor Live di YouTube Creator Studio. Siaran lain di channel ini adalah siaran acara.
-
-
Kolom
status.healthStatus.configurationIssues[].typeresourceliveStreammelaporkan error status kondisi baru berikut:Error audioTooManyChannelsAudio ini memiliki lebih dari dua channel, tetapi hanya satu (mono) atau dua (stereo) channel yang didukung. Perbaiki jumlah channel audio. frameRateHighKecepatan frame saat ini terlalu tinggi. Setel kecepatan frame ke fps atau lebih rendah.%(framerate)s -
Tanggal publikasi pembaruan dokumentasi sebelumnya telah diperbaiki.
-
Error baru dan yang diperbarui
-
Selain error yang ditentukan untuk resource baru yang tercantum di atas, API mendukung error baru berikut:
Detail error liveBroadcasts.updateKode Respons HTTP forbidden (403)Alasan closedCaptionsTypeModificationNotAllowedDeskripsi Nilai contentDetails.closedCaptionsTypehanya dapat diubah saat siaran dalam statuscreatedatauready.liveBroadcasts.updateKode Respons HTTP invalidValue (400)Alasan invalidEnableClosedCaptionsDeskripsi Dalam resource liveBroadcast, nilai properti contentDetails.enableClosedCaptionstidak kompatibel dengan nilai setelancontentDetails.closedCaptionType. Ubah resource agar hanya menyertakan salah satu dari dua properti, lalu kirim ulang permintaan.
-
19 Agustus 2015
Update ini berisi perubahan berikut:
-
Resource dan metode baru
-
Catatan: Dokumentasi untuk resource
liveChatdan metodenya bersifat rahasia dan hanya dapat dilihat oleh partner YouTube tertentu.Resource
liveChatbaru berisi komentar yang diposting selama siaran langsung di YouTube. API ini mendukung dua metode untuk resource ini:Metode liveChats.listMencantumkan pesan live chat untuk siaran. liveChats.insertBuat pesan chat baru. Pesan live chat hanya dapat diambil dan diposting saat siaran sedang berlangsung.
-
-
Pembaruan pada resource dan metode yang ada
-
Resource
liveStreamberisi properti baru berikut:Properti snippet.isDefaultStreamMenunjukkan apakah streaming ini adalah streaming default untuk channel. Streaming default channel ada tanpa batas waktu, tidak memiliki waktu mulai atau berakhir yang terkait dengannya, dan tidak dapat dihapus. Lihat definisi properti untuk mengetahui informasi selengkapnya tentang cara kerja aliran default. status.healthStatusObjek ini berisi informasi yang dapat digunakan untuk mengidentifikasi, mendiagnosis, dan menyelesaikan masalah streaming. Objek ini berisi sejumlah properti turunan untuk membantu Anda mengevaluasi kualitas streaming video live.
Khususnya, objekstatus.healthStatus.configurationIssues[]mencantumkan masalah yang memengaruhi streaming video. Dokumen baru, Masalah Konfigurasi untuk Resource LiveStream, mencantumkan semua masalah yang dilaporkan API.contentDetails.isReusableMenunjukkan apakah stream dapat digunakan kembali, yang berarti stream 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
liveBroadcastberisi properti baru berikut:Properti snippet.isDefaultBroadcastMenunjukkan apakah siaran ini adalah siaran default untuk saluran. Saat channel YouTube diaktifkan untuk live streaming, YouTube akan membuat streaming default dan siaran default untuk channel tersebut. Stream menentukan cara pemilik channel mengirimkan video live ke YouTube, dan siaran adalah cara penonton dapat melihat stream default. Lihat definisi properti untuk mengetahui informasi selengkapnya tentang cara kerja siaran default. contentDetails.enableLowLatencyMenunjukkan apakah siaran ini harus dienkode untuk streaming latensi rendah. Streaming latensi rendah dapat mengurangi waktu yang diperlukan agar video dapat dilihat oleh pengguna yang menonton siaran, meskipun juga dapat memengaruhi resolusi bagi penonton streaming. statistics.totalChatCountJumlah 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 siaran live yang telah selesai.
-
-
Error baru dan yang diperbarui
-
Selain error yang ditentukan untuk resource
liveChatbaru, API mendukung error baru berikut:Detail error liveStreams.updateKode Respons HTTP forbidden (403)Alasan liveStreamModificationNotAllowedDeskripsi API tidak memungkinkan Anda mengubah aliran 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 live streaming video 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 pada 60 fps, YouTube juga menyediakan streaming dalam 30 fps di perangkat yang belum mendukung penayangan dengan kecepatan frame tinggi.
Properti
cdn.formatresourceliveStreammendukung dua nilai baru untuk fitur ini:720p_hfrdan1080p_hfr.Lihat Blog Kreator YouTube untuk mengetahui informasi selengkapnya tentang fitur ini.
21 Agustus 2014
Update ini berisi perubahan berikut:
-
Definisi parameter
walltimemetodeliveBroadcasts.controltelah diperbarui untuk mencatat bahwa nilai properti ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ). -
API kini mendukung error berikut:
Jenis error Detail error Deskripsi insufficientPermissionsliveStreamingNotEnabledSemua metode untuk resource liveBroadcastdanliveStreammenampilkan 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.rateLimitExceededuserRequestsExceedRateLimitMetode liveBroadcasts.insertdanliveStreams.insertmenampilkan 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
liveStreamdan metodeliveBroadcasts.bindtelah diperbarui untuk mencatat bahwa siaran hanya dapat terikat ke satu streaming video, tetapi streaming video dapat terikat ke lebih dari satu siaran. Perubahan ini hanya berupa koreksi pada dokumentasi; fungsi API yang mendasarinya tidak berubah. -
Properti
contentDetails.monitorStream.enableMonitorStreamresourceliveBroadcasttelah diperbarui untuk menjelaskan bahwa jika nilai properti adalahtrue, Anda harus mentransisikan siaran ke statustestingsebelum dapat mentransisikannya ke statuslive. (Jika nilai properti adalahfalse, siaran Anda tidak dapat memiliki tahaptesting, sehingga Anda dapat mentransisikan siaran langsung ke statuslive. -
Properti
settings.offsetTimeMsresourceliveCuepointtelah diperbarui untuk mencatat bahwa Anda tidak boleh menentukan nilai untuk properti jika siaran Anda tidak memiliki aliran monitor. -
Semua metode untuk resource
liveBroadcastdanliveStreamkini mendukung parameteronBehalfOfContentOwnerdanonBehalfOfContentOwnerChannel. Dengan parameter ini, Anda dapat menggunakan kredensial otorisasi yang sama untuk menyelesaikan permintaan API untuk berbagai channel yang terkait dengan pemilik konten yang sama. -
Dokumentasi metode
liveCuepoints.inserttelah diperbarui untuk mencatat bahwa Anda dapat menetapkan nilai untuk propertisettings.walltimesaat memanggil metode tersebut. -
Dokumentasi error kini menentukan kode respons HTTP untuk setiap jenis error.
-
API kini mendukung error berikut:
Jenis error Detail error Deskripsi insufficientPermissionslivePermissionBlockedMetode liveBroadcasts.insert,liveBroadcasts.transition, danliveStreams.insertmenampilkan 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
invalidScheduledStartTimemetodeliveBroadcasts.inserttelah 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.recordingStatusbaru resourceliveBroadcastmengidentifikasi status siaran saat ini. -
Properti
contentDetails.enableClosedCaptionsbaru resourceliveBroadcastmenunjukkan 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 statustestingataulive. Jika Anda menyetel properti ini ketrue, resourceliveStreamyang terikat ke siaran akan menentukan URL penyerapan yang akan digunakan untuk teks tertutup siaran. -
Properti
snippet.scheduledEndTimeresourceliveBroadcastkini mendukung siaran yang dijadwalkan untuk berlanjut tanpa batas. Dengan perubahan ini, properti tidak lagi diperlukan dalam permintaanliveBroadcasts.insertdanliveBroadcasts.update.
Jika Anda mengambil resourceliveBroadcastyang tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk berlanjut tanpa batas waktu. Demikian pula, jika Anda memanggil metodeliveBroadcasts.insertatauliveBroadcasts.updatedan tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk berlanjut tanpa batas. -
Properti
contentDetails.recordFromStartresourceliveBroadcast, yang sudah memiliki nilai defaulttrue, kini hanya dapat disetel kefalsejika saluran penyiaran diizinkan untuk menonaktifkan rekaman untuk siaran langsung.Jika channel Anda tidak memiliki izin untuk menonaktifkan rekaman, dan Anda mencoba menyisipkan siaran dengan properti
recordFromStartyang ditetapkan kefalse, API akan menampilkan errorForbidden. Selain itu, jika channel Anda tidak memiliki izin tersebut dan Anda mencoba memperbarui siaran untuk menyetel propertirecordFromStartkefalse, API akan menampilkan errormodificationNotAllowed. -
Resource
liveBroadcasttidak lagi berisi propertienableArchive, yang telah disebutkan dalam deskripsi properticontentDetails.enableDvrdancontentDetails.enableEmbed. -
Daftar nilai valid untuk properti
status.lifeCycleStatusresourceliveBroadcasttelah diperbarui untuk menyertakan deskripsi setiap status. -
Properti
settings.walltimebaru resourceliveCuepointmenentukan tanggal dan waktu saat cuepoint harus disisipkan. API akan menampilkan error jika permintaan mencoba menyisipkan titik cue yang menentukan nilai untuk properti ini dan untuk propertisettings.offsetTimeMs. -
Objek
contentDetailsbaru dalam resourceliveStreamberisi informasi tentang streaming. Saat ini, satu-satunya properti objek adalahcontentDetails.closedCaptionsIngestionUrl, yang menentukan URL penyerapan untuk teks tertutup yang terkait dengan streaming video. -
Daftar nilai valid untuk properti
status.streamStatusresourceliveStreamtelah diperbarui untuk menyertakan deskripsi setiap status. -
Parameter
walltimebaru metodeliveBroadcasts.controlmemungkinkan Anda menentukan tanggal dan waktu terjadinya perubahan slate. API akan menampilkan error jika permintaan menentukan nilai untuk parameter ini dan untuk parameteroffsetTimeMs. -
Dalam respons API terhadap permintaan
liveBroadcasts.list, nilai propertikindtelah berubah dariyoutube#liveBroadcastListmenjadiyoutube#liveBroadcastListResponse. -
Dalam respons API terhadap permintaan
liveStreams.list, nilai propertikindtelah berubah dariyoutube#liveStreamListmenjadiyoutube#liveStreamListResponse. -
Properti
eventIdtidak digunakan lagi dariliveBroadcastListResponsedanliveStreamListResponse. -
API ini mendukung error baru berikut:
Jenis error Detail error Deskripsi invalidValueconflictingTimeFieldsMetode liveBroadcasts.controlmenampilkan error ini jika permintaan Anda menentukan nilai untuk parameteroffsetTimeMsdanwalltime. Permintaan dapat menghilangkan kedua parameter atau menentukan nilai untuk salah satu dari kedua parameter.invalidValueinvalidWalltimeMetode liveBroadcasts.controlmenampilkan error ini jika nilai parameterwalltimetidak valid.forbiddenenableClosedCaptionsModificationNotAllowedMetode liveBroadcasts.updatemenampilkan error ini jika Anda mencoba memperbarui nilaicontentDetails.enableClosedCaptionsdan status siaran bukancreatedatauready.invalidValueconflictingTimeFieldsMetode liveCuepoints.insertmenampilkan error ini jika permintaan Anda menentukan nilai untuk propertisettings.offsetTimeMsdansettings.walltime. Permintaan dapat menghilangkan kedua properti atau menentukan nilai untuk salah satu dari kedua properti tersebut.Selain itu, metode
liveStreams.updatetidak lagi mendukung errorcdnRequiredyang mirip dengan yang didukung oleh metodeliveStreams.insert.
10 Mei 2013
Update ini berisi perubahan berikut:
-
YouTube tidak lagi mengidentifikasi fitur dan layanan API eksperimental. Sebagai gantinya, kami kini menyediakan daftar YouTube API yang tunduk pada kebijakan penghentian layanan.
2 Mei 2013
Update ini berisi perubahan berikut:
-
Metode
liveBroadcasts.controlbaru memungkinkan Anda mengubah setelan tampilan untuk tablet yang ditampilkan dalam streaming siaran untuk siaran yang sudah berlangsung. Jika streaming siaran tertunda, Anda juga dapat menggunakan metode ini untuk menentukan offset waktu saat perubahan layar yang diminta akan terjadi. -
Definisi properti berikut telah diperbarui untuk menjelaskan bahwa nilai properti harus ditetapkan jika Anda memperbarui bagian
contentDetailsresourceliveBroadcast: -
status.streamStatusresourceliveStreamtidak lagi mendukung nilaideletedsebagai kemungkinan status streaming. -
Informasi yang ditampilkan API untuk banyak pesan error telah direvisi untuk menjelaskan dengan lebih baik alasan terjadinya error tertentu. API ini juga mendukung beberapa error baru.
27 Maret 2013
Update ini berisi perubahan berikut:
-
Properti berikut telah berubah di resource
liveBroadcast:- Properti
startWithSlateCuepointtelah diganti namanya menjadistartWithSlate. - Properti
enableArchivetelah diganti namanya menjadirecordFromStart. - Objek
slateSettingstelah dihentikan dan dihapus dari dokumentasi. Pesan error yang terkait dengan objekslateSettingsatau propertinya juga telah dihapus. Terakhir, bagian "Menampilkan Slate" dalam panduan Memulai telah dihapus.
- Properti
-
API tidak lagi mendukung kemampuan untuk menyisipkan layar jeda dalam streaming menggunakan metode
liveCuepoints.insert. Dokumen berikut telah diperbarui untuk mencerminkan perubahan ini:-
Halaman indeks, panduan Mulai, dan tutorial Siklus proses siaran tidak lagi menyebutkan fungsi ini.
-
Properti
settings.cueTyperesourceliveCuepointtidak lagi mendukungslatesebagai nilai properti. (Satu-satunya nilai yang didukung adalahad. -
Properti
settings.eventStateresourceliveCuepointtelah dihentikan dan dihapus dari dokumentasi.
-
18 Maret 2013
Update ini berisi perubahan berikut:
-
Semua pesan error API telah diupdate 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 terjadwal.liveBroadcasts.insert– Siaran menentukan status privasi yang tidak valid.liveBroadcasts.update– Resource tidak berisi atau tidak menetapkan nilai untuk properticontentDetails.enableArchive.liveBroadcasts.update– Resource tidak berisi atau tidak menetapkan nilai untuk properticontentDetails.enableContentEncryption.liveBroadcasts.update– Resource tidak berisi atau tidak menetapkan nilai untuk properticontentDetails.enableDvr.liveStreams.insert– Judul cuplikan harus memiliki panjang antara 1 dan 128 karakter.liveStreams.update– Resource tidak berisi atau tidak menetapkan nilai untuk propertisnippet.title.
-
Dokumentasi resource
liveStreamtelah diperbarui untuk mencerminkan bahwa multicast dan WebM bukan metode penyerapan yang didukung seperti yang ditunjukkan sebelumnya. Daftar format untuk properticdn.formattelah diperbarui sebagaimana mestinya, dan objekcdn.multicastIngestionInfoserta properti turunannya telah dihapus dari dokumentasi resource. Selain itu,httptelah dihapus dari daftar nilaicdn.ingestionTypeyang didukung.