Halaman ini berisi daftar perubahan dan pembaruan dokumentasi YouTube Live Streaming API. Berlangganan log perubahan ini.
9 Oktober 2023
Sebagai referensi, Anda dapat menemukan ID Stiker yang berkaitan 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 sekarang mendukung cara baru menyisipkan iklan ke live streaming. Selain
liveCuepoints
, yang memungkinkan Anda
menyisipkan jeda iklan ke siaran secara manual, 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:
- durasi interval antara jeda iklan mid-roll.
- strategi penjadwalan untuk titik tanda iklan. Titik tanda dapat disisipkan secara serentak untuk semua pelihat atau waktu titik tanda dapat bervariasi dari satu penonton ke penonton lainnya. Dengan strategi yang terakhir, YouTube dapat menjadwalkan titik tanda pada peningkatan kecepatan sehingga penonton dapat menerima titik tanda saat memenuhi syarat untuk melakukannya.
- periode saat iklan mid-roll tidak ditampilkan; untuk fitur ini, pemilik siaran menentukan bahwa penyisipan iklan mid-roll dijeda hingga jangka waktu tertentu.
Dokumentasi menunjukkan perubahan API berikut untuk mendukung fitur ini:
- Resource
liveBroadcast
sekarang berisi objekmonetizationDetails
. Kolom objek menunjukkan apakah penyisipan iklan otomatis diaktifkan untuk siaran dan menentukan informasi tambahan untuk titik tanda penjadwalan. - Parameter
part
metodeliveBroadcast.list
mendukung nilaimonetizationDetails
. - Metode
update
dapat digunakan untuk menjeda penyisipan iklan mid-roll selama jangka waktu tertentu untuk live streaming. Kini, 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 tidak ada dalam permintaan, kolom tersebut tidak akan berubah.
1 November 2022
-
Dengan metode
liveBroadcasts.cuepoint
baru, setiap pemilik channel yang menjalankan live streaming di YouTube dapat memasukkan titik tanda ke siaran tersebut, yang dapat memicu jeda iklan. Metode ini menggantikan metodeliveCuepoints.insert
, yang hanya memungkinkan partner konten YouTube menyisipkan titik tanda ke dalam live streaming.Beberapa panduan telah diperbarui untuk mencerminkan ketersediaan metode baru ini.
-
Catatan: Ini adalah pengumuman penghentian.
Metode
liveCuepoints.insert
kini tidak digunakan lagi. Dukungan untuk metodeliveCuepoints.insert
akan dihapus pada atau setelah 1 Mei 2023. Pengguna API harus mengupdate aplikasi mereka untuk memanggil metodeliveBroadcasts.cuepoint
. -
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 mengharuskan nilai yang ditentukan untuk kolom ini:contentDetails.enableContentEncryption
contentDetails.enableDvr
contentDetails.enableEmbed
contentDetails.recordFromStart
contentDetails.startWithSlate
Jika kolom ini tidak ada dalam 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:
-
Properti
snippet.type
kini mendukung dua nilai baru:membershipGiftingEvent
giftMembershipReceivedEvent
-
Properti
snippet.membershipGiftingDetails
baru resourceliveChatMessage
dan turunannya berisi informasi tentang acara Hadiah Langganan. Demikian pula, propertisnippet.giftMembershipReceivedDetails
yang baru dan turunannya akan berisi informasi tentang peristiwa Hadiah Langganan Diterima.
15 September 2021
Update ini berisi perubahan berikut:
-
Properti
snippet.type
kini mendukung dua nilai baru:newSponsorEvent
memberMilestoneChatEvent
-
Properti
snippet.memberMilestoneChatDetails
baru resourceliveChatMessage
dan turunannya berisi informasi tentang acara Chat Pencapaian Pelanggan. Demikian pula, propertisnippet.newSponsorDetails
yang baru dan turunannya berisi informasi tentang peristiwa 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
resourceliveBroadcast
telah diperbarui untuk memperjelas bahwa properti ini bersifat hanya baca. Hal ini tidak mencerminkan perubahan pada fungsi API.Untuk menetapkan live streaming sebagai ditujukan untuk anak-anak, tetapkan properti
status.selfDeclaredMadeForKids
ketrue
saat memanggil metodeliveBroadcasts.insert
untuk membuat siaran. -
Catatan: Perubahan ini mencakup pengumuman penghentian dan pembaruan pengumuman penghentian sebelumnya.
Metode
liveBroadcasts.control
tidak akan digunakan lagi pada atau setelah 1 Oktober 2020. Setelah tanggal itu, semua panggilan ke metode ini akan menampilkan error terlarang (403), dan metode ini nantinya akan dihapus sepenuhnya. Klien masih dapat menerapkan jadwalnya sendiri dengan menambahkan overlay ke video yang dikirim ke server proses transfer YouTube.Tanggal penghentian pengumuman penghentian yang dibuat pada 16 April 2020, yang awalnya dijadwalkan untuk 1 September 2020, telah diundur dan kini akan terjadi pada atau setelah 1 Oktober 2020. Dengan demikian, fitur yang disertakan dalam pengumuman penghentian tersebut dan metode
liveBroadcasts.control
tidak akan digunakan lagi secara bersamaan.
17 Juli 2020
Catatan: Ini adalah pembaruan dari 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 pada tanggal tersebut.
Jika masih menggunakan kolom cdn.format
, kode Anda harus diupdate untuk menentukan
kecepatan dan resolusi frame secara terpisah, menggunakan
properti
cdn.frameRate
dan
cdn.resolution
.
6 Juli 2020
Panduan Menayangkan 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 Proses Transfer HLS dari YouTube Creator Studio.
-
Petunjuk untuk memformat nilai parameter
file
telah dipindahkan ke bagian Menyelesaikan URL Proses Transfer HLS yang baru. Petunjuk ini berlaku terlepas dari apakah URL proses transfer HLS diperoleh dari YouTube API atau YouTube Creator Studio.
Selain itu, perbandingan protokol penyerapan yang baru mencantumkan protokol proses transfer 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
sekarang mendukung properticontentDetails.enableAutoStop
. Properti ini menunjukkan apakah siaran akan otomatis berhenti sekitar satu menit setelah pemilik channel menghentikan streaming video pada streaming video terikat.Masa berlaku dokumen siaran telah diperbarui untuk menjelaskan bagaimana proses langkah demi langkah pembuatan dan pengelolaan acara YouTube live berubah jika Anda menetapkan properti
contentDetails.enableAutoStart
ataucontentDetails.enableAutoStop
ketrue
. -
Catatan: Ini adalah pengumuman penghentian. Perubahan ini akan mulai berlaku pada atau setelah 1 September 2020. Tanggal sebenarnya saat perubahan mulai berlaku disebut di bawah sebagai tanggal penghentian penggunaan.
Pembaruan ini menjelaskan perubahan yang berpotensi dapat menyebabkan gangguan. Kebijakan ini memengaruhi aplikasi klien API yang menggunakan resource
liveStream
danliveBroadcast
default saluran untuk melakukan streaming konten live di YouTube. Secara khusus, ID siaran dan ID streaming yang terkait dengan siaran dan streaming persisten tidak akan lagi berfungsi untuk memulai siaran baru.Permohonan Anda akan terpengaruh jika salah satu kondisi berikut terpenuhi:
- Metode ini memeriksa nilai properti
isDefaultBroadcast
resourceliveBroadcast
. Properti ini tidak akan dikembalikan setelah tanggal penghentian. - Metode ini memeriksa nilai properti
isDefaultStream
resourceliveStream
. Properti ini tidak akan dikembalikan setelah tanggal penghentian. - Metode ini memanggil
metode
liveBroadcasts.list
dan menetapkan parameter valuebroadcastType
kepersistent
atauall
. Parameter ini tidak akan digunakan lagi sebagai bagian dari perubahan ini. Sejak tanggal penghentian penggunaan:- Jika nilai parameter
broadcastType
adalahpersistent
, maka metodeliveBroadcasts.list
tidak akan menampilkan hasil apa pun. - Jika parameter value
broadcastType
adalahall
, metodeliveBroadcasts.list
tidak akan menampilkan siaran persisten yang ada sebelum waktu itu.
- Jika nilai parameter
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. Stream default ada tanpa batas waktu, tidak memiliki waktu mulai atau berakhir yang terkait dengannya, dan tidak dapat dihapus. Demikian pula, siaran default dianggap tetap. Class ini selalu ada dan tidak terikat dengan peristiwa tertentu.
Sejak tanggal penghentian:
- YouTube tidak akan membuat streaming dan siaran default lagi. Daripada mengandalkan
resource default, klien API harus dapat membuat dan mengelola
resource
liveBroadcast
danliveStream
serta mengikat resource tersebut bersama-sama. - Jika siaran default dan streaming default channel sedang live secara aktif, yang berarti channel menggunakannya untuk live streaming pada saat penghentian mulai diberlakukan, siaran yang sedang berlangsung tidak akan terpengaruh. Namun, setelah siaran tersebut berakhir, saluran tidak akan dapat menggunakan siaran default dan streaming default lagi.
- Jika siaran default dan streaming default channel tidak aktif secara live, maka setelah penghentian ini berlaku, YouTube akan mengabaikan upaya penggunaan 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 ditangani developer di klien API yang saat ini menggunakan streaming dan siaran default.
- Panduan Proses siaran memandu Anda dalam langkah demi langkah proses yang menjelaskan cara membuat dan mengelola live streaming 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.
- Metode ini memeriksa nilai properti
31 Maret 2020
Catatan: Ini adalah pengumuman penghentian.
Resource sponsor
dan metode sponsors.list
tidak digunakan lagi dan diganti dengan resource member
dan metode members.list
.
Metode sponsors.list
tidak akan didukung lagi pada atau setelah 30 September 2020.
Klien API harus memperbarui panggilan ke metode sponsors.list
untuk menggunakan
metode members.list
. Baca
histori revisi YouTube Data API untuk mengetahui informasi lebih lanjut
tentang referensi baru ini.
11 Maret 2020
Bagian Endpoint proses transfer
pada panduan Menayangkan Konten YouTube Live melalui HLS telah diperbarui untuk
memperjelas proses yang harus digunakan encoder untuk menyelesaikan nilai parameter file=
saat membuat URL proses transfer utama dan cadangan.
4 Februari 2020
Panduan Menayangkan Konten YouTube Live melalui HLS
telah diperbarui untuk memperhatikan bahwa permintaan DELETE
bersifat opsional dan endpoint
HLS YouTube mengabaikannya. Untuk alasan performa, YouTube merekomendasikan klien untuk tidak mengirim
permintaan DELETE
.
January 10, 2020
API ini kini mendukung kemampuan untuk mengidentifikasi konten yang ditujukan untuk anak-anak, yang oleh YouTube disebut sebagai "Dibuat untuk Anak-Anak". Pelajari lebih lanjut konten yang "Dibuat untuk Anak-Anak" di Pusat Bantuan YouTube.
-
Resource
liveBroadcast
mendukung dua properti baru agar kreator dan penonton konten dapat mengidentifikasi konten yang "Dibuat untuk Anak-Anak":-
Properti
selfDeclaredMadeForKids
memungkinkan kreator konten menentukan apakah live streaming merupakan konten untuk anak-anak atau tidak. Properti ini dapat disetel saat membuat siaran melalui metodeliveBroadcasts.insert
. Perhatikan bahwa properti ini hanya disertakan dalam respons API yang berisi resourceliveBroadcast
jika pemilik saluran mengizinkan permintaan API. -
Properti
madeForKids
memungkinkan pengguna API mengambil status siaran "Dibuat untuk Anak-Anak". Misalnya, status mungkin 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
channel
juga mendukung propertiselfDeclaredMadeForKids
danmadeForKids
yang baru.
Kami juga telah memperbarui Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer. Silakan lihat Persyaratan Layanan YouTube API untuk Layanan - Histori Revisi untuk mengetahui informasi selengkapnya. Perubahan pada Persyaratan Layanan dan Kebijakan Developer Layanan YouTube API akan berlaku mulai 10 Januari 2020 Waktu Pasifik.
20 Agustus 2019
Bagian Persyaratan dalam panduan Menayangkan Konten YouTube Live melalui HLS telah diperbarui dengan dua perubahan:
- Dijelaskan bahwa praktik terbaiknya adalah menyertakan segmen yang diakui dan segmen yang belum terselesaikan di setiap Playlist Media. Praktik ini memperkecil kemungkinan segmen dilewati jika Playlist Media hilang di sisi server. Misalnya, Anda dapat menyertakan hingga dua segmen yang diakui dan hingga lima segmen yang belum diselesaikan di setiap Playlist Media.
- Sekarang, Anda harus mengirimkan Playlist Media untuk setiap Segmen Media. Tindakan ini memungkinkan server pulih dengan cepat jika Playlist Media hilang. Praktik ini sebelumnya tercantum sebagai rekomendasi.
28 Juni 2019
YouTube kini mendukung proses transfer HLS. Dengan demikian, properti ingestionType
resource liveStream
mendukung nilai baru hls
untuk mengidentifikasi streaming yang diserap ke YouTube menggunakan HLS.
Panduan Menayangkan Konten YouTube Live melalui HLS yang baru memberikan pedoman untuk menggunakan HLS untuk melakukan streaming konten live ke YouTube dari encoder. Panduan ini bertujuan untuk membantu vendor encoder menambahkan dukungan pengiriman HLS ke produk mereka.
4 April 2019
Update ini berisi perubahan berikut:
-
Dokumentasi referensi API telah diperbarui untuk menjelaskan kasus penggunaan umum dengan lebih baik untuk setiap metode dan untuk memberikan contoh kode dinamis berkualitas tinggi melalui widget APIs Explorer. Lihat dokumentasi metode
liveBroadcasts.list
untuk mengetahui contohnya. Kini ada dua elemen baru di halaman yang menjelaskan metode API:-
Widget Penjelajah API memungkinkan Anda memilih cakupan otorisasi, memasukkan contoh parameter dan nilai properti, lalu mengirim permintaan API yang sebenarnya dan melihat respons API yang sebenarnya. Widget juga menawarkan tampilan layar penuh yang menampilkan contoh kode lengkap, yang secara dinamis diperbarui 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 Penjelajah API dengan nilai contoh untuk kasus penggunaan Anda atau untuk membuka Penjelajah API layar penuh dengan nilai tersebut sudah terisi. Perubahan ini bertujuan untuk memudahkan Anda melihat contoh kode yang langsung berlaku untuk kasus penggunaan yang ingin Anda implementasikan dalam 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 menggunakan alat tersebut, Anda dapat menjelajahi kasus penggunaan untuk berbagai metode, memuat nilai ke dalam APIs Explorer, dan membuka API Explorer layar penuh untuk mendapatkan contoh kode di Java, JavaScript, PHP, dan Python.
Bersama 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 Stickers dibeli oleh penggemar selama live stream YouTube.
- Di resource
liveChatMessage
, propertisnippet.type
kini disetel kesuperStickerEvent
untuk menunjukkan bahwa resource berisi informasi tentang Super Stickers. Dalam hal ini, resource juga berisi objeksnippet.superStickerDetails
, yang berisi informasi tambahan tentang Super Stickers. - Di resource
superChatEvent
, booleansnippet.isSuperStickerEvent
menunjukkan apakah pesan Super Chat juga merupakan Super Stickers atau tidak. Jika demikian, objeksnippet.superStickerMetadata
akan berisi detail tambahan tentang Super Stickers.
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 2017.
3 April 2017
Contoh kode Java baru telah ditambahkan untuk menunjukkan cara mencantumkan, menyisipkan, dan menghapus pesan live chat. Contoh tersebut 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 parameteronBehalfOfContentOwner
saat ini diperlukan. Selain itu, deskripsi metode telah diperbarui untuk menunjukkan 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 metodesuperChatEvents.list
memungkinkan Anda menentukan bahwa nilai propertisnippet.displayString
harus diformat sesuai dengan konvensi bahasa tertentu. Definisi properti tersebut juga telah diperbarui.Nilai parameter harus berupa kode bahasa yang disertakan dalam daftar yang ditampilkan oleh metode
i18nLanguages.list
. Nilai defaultnya adalahen
, yang berarti perilaku default-nya 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 mewakili pesan Super Chat yang dibeli oleh penggemar selama live stream YouTube. Dalam streaming live chat YouTube, Super Chat berbeda dari pesan lainnya dalam dua hal:- Super Chat ditandai dengan warna.
- Super Chat terus disematkan di ticker dalam jangka waktu tertentu.
Warna Super Chat, jangka waktu untuk tetap disematkan di ticker, dan panjang pesan maksimum ditentukan oleh jumlah pembelian. Pusat Bantuan YouTube memiliki informasi lebih lanjut mengenai Super Chat.
API mendukung metode untuk mencantumkan peristiwa Super Chat untuk live stream channel dalam 30 hari sebelumnya. Metode tersebut juga menampilkan data tentang acara Fan Funding (
fanFundingEvents
) dari live stream terakhir channel.
-
-
Pembaruan pada resource dan metode yang ada
-
Properti
snippet.type
kini mendukung nilaisuperChatEvent
, yang menunjukkan bahwa resource menjelaskan Super Chat.Selain itu, properti
snippet.superChatDetails
baru resourceliveChatMessage
dan turunannya berisi informasi tentang acara Super Chat. -
Properti
cdn.resolution
resourceliveStream
sekarang mendukung nilai2160p
.
-
-
Error baru dan yang diperbarui
-
API ini mendukung error baru berikut:
Detail error liveBroadcasts.insert
,liveBroadcasts.update
Metode liveBroadcasts.insert
danliveBroadcasts.update
menampilkan error400
(Bad Request
) untuk menunjukkan bahwa resourceliveBroadcast
yang disisipkan atau diperbarui berisi nilai yang tidak valid untuk properticontentDetails.enableEmbed
atau properticontentDetails.projection
. Alasan error untuk dua error baru masing-masing adalahinvalidEmbedSetting
daninvalidProjection
.
-
12 Januari 2017
Catatan: Ini adalah pengumuman penghentian.
Bersama dengan rilis fitur Super Chat baru, YouTube telah menghentikan penggunaan fitur Fan Funding, dan Fan Funding API akan dinonaktifkan pada tanggal 28 Februari 2017. Sejak tanggal tersebut:
- Metode
liveChatMessages.list
tidak akan lagi menampilkan pesan dengansnippet.type
bernilaifanFundingEvent
. Demikian pula, resourceliveChatMessage
tidak akan lagi berisi objeksnippet.fanFundingEventDetails
. - Metode
fanFundingEvents.list
tidak 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 dalam Blog Developer dan Engineering YouTube, memberikan serangkaian pembaruan lengkap terkait Persyaratan Layanan saat ini. Selain Persyaratan yang Diperbarui, yang akan berlaku mulai 10 Februari 2017, pembaruan ini menyertakan beberapa dokumen pendukung untuk membantu menjelaskan kebijakan yang harus dipatuhi oleh developer.
Kumpulan lengkap dokumen baru dijelaskan di 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 perubahan listingan feed RSS dalam histori revisi tersebut dari link dalam dokumen tersebut.
20 Mei 2016
YouTube kini mendukung proses transfer DASH. Dengan demikian, properti ingestionType
resource liveStream
mendukung nilai baru dash
untuk mengidentifikasi streaming yang diserap ke YouTube menggunakan DASH.
Panduan Menayangkan Konten YouTube Live melalui DASH yang baru memberikan panduan 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 materi
liveStream
-
YouTube kini mendukung streaming dengan resolusi 1440p pada kecepatan 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
dan60fps
.cdn.resolution
Resolusi data video masuk. Nilai properti yang valid adalah: 1440p
,1080p
,720p
,480p
,360p
, dan240p
. -
Sesuai dengan pengenalan properti
cdn.frameRate
dancdn.resolution
resourceliveStream
,cdn.format
resource kini tidak digunakan lagi. Properticdn.format
menentukan resolusi dan kecepatan frame dalam satu nilai.Sebaiknya Anda beralih ke kolom baru yang didukung. Sementara itu,
cdn.format
akan terus berfungsi. Selain itu, permintaan untuk menyisipkan live stream saat ini berhasil selama Anda menentukan nilai untuk properticdn.format
atau properticdn.frameRate
dancdn.resolution
. Jika Anda memberikan nilai untuk ketiga properti, API mungkin akan menampilkan error jika nilainya tidak sesuai.Perlu diperhatikan bahwa meskipun properti
cdn.format
tidak digunakan lagi, properti tersebut kini mendukung dua nilai baru,1440p
dan1440p_hfr
, untuk mencerminkan dukungan API untuk streaming 1440p pada 30 atau 60 frame per detik.
-
- Pembaruan materi
liveBroadcast
-
Resource
liveBroadcast
berisi properti baru berikut:Properti contentDetails.boundStreamLastUpdateTimeMs
Tanggal dan waktu live stream yang dirujuk oleh properti contentDetails.boundStreamId
siaran terakhir diperbarui.contentDetails.projection
Format proyeksi siaran. Nilai default properti adalah rectangular
. Nilai yang valid untuk properti adalah360
danrectangular
. -
Definisi properti
statistics.totalChatCount
resourceliveBroadcast
telah diperbarui untuk memperhatikan bahwa nilai properti hanya muncul jika siaran memiliki setidaknya satu pesan chat.
-
- Pembaruan materi
liveChatMessage
-
Properti
snippet.type
mendukung dua nilai baru –messageDeletedEvent
danuserBannedEvent
– yang sesuai dengan properti baru yang dijelaskan dalam poin butir berikut. Definisi propertisnippet.authorChannelId
juga telah diperbarui untuk menjelaskan nilai properti yang diidentifikasi 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 ini hanya ada jika nilai properti snippet.type
adalahmessageDeletedEvent
.snippet.userBannedDetails
Objek ini berisi informasi tentang pengguna yang telah diblokir agar tidak berpartisipasi dalam chat. Objek ini juga berisi informasi tentang pemblokiran itu sendiri, yaitu apakah pemblokiran tersebut bersifat permanen atau sementara. Jika pemblokiran bersifat sementara, salah satu properti objek akan menentukan durasi pemblokiran.
Objek ini hanya ada jika nilai propertisnippet.type
adalahuserBannedEvent
.
-
- Pembaruan materi
-
Error baru dan yang diperbarui
-
API ini mendukung error baru berikut:
Detail error liveBroadcasts.bind
Metode liveBroadcasts.bind
menampilkan error403
(Forbidden
) untuk menunjukkan bahwa pengguna telah mengirim terlalu banyak permintaan dalam jangka waktu tertentu. Alasan error adalahuserRequestsExceedRateLimit
.
MetodeliveBroadcasts.insert
danliveBroadcasts.update
sudah mendukung error yang sama.liveStreams.insert
Metode liveStreams.insert
mendukung empat error400
(Bad Request
) baru yang mengidentifikasi nilai properti yang tidak valid di resourceliveStream
yang coba disisipkan oleh permintaan. Daftar berikut mengidentifikasi alasan error dan properti yang terkait dengannya:
invalidFormat
:cdn.format
invalidFrameRate
:cdn.frameRate
invalidIngestionType
:cdn.ingestionType
invalidResolution
:cdn.resolution
liveStreams.insert
Metode liveStreams.insert
mendukung dua error400
(Bad Request
) baru, yang masing-masing menunjukkan bahwa nilai yang diperlukan tidak ada di resourceliveStream
yang coba disisipkan oleh permintaan. Daftar berikut mengidentifikasi alasan error dan properti yang terkait dengannya:
frameRateRequired
:cdn.frameRate
resolutionRequired
:cdn.resolution
liveStream
, Anda harus menentukan nilai untuk properticdn.format
atau untuk properticdn.frameRate
dancdn.resolution
.
- API menampilkan error
formatRequired
jika Anda tidak menetapkan nilai untuk ketiga properti. - API akan menampilkan error
frameRateRequired
jika Anda menentukan nilai untukcdn.resolution
, tetapi tidakcdn.frameRate
. - API akan menampilkan error
resolutionRequired
jika Anda menentukan nilai untukcdn.frameRate
, tetapi tidakcdn.resolution
.
liveStreams.update
Metode liveStreams.update
menampilkan error403
(Forbidden
) jika permintaan mencoba mengubah nilai properti yang tidak dapat diubah berikut:cdn.format
cdn.frameRate
cdn.ingestionType
cdn.resolution
reason
dalam respons error adalahliveStreamModificationNotAllowed
.
-
18 Desember 2015
Hukum Uni Eropa (EU) mewajibkan pengungkapan tertentu kepada pengguna akhir di Uni Eropa dan izin yang diperoleh. Oleh karena itu, untuk pengguna akhir di Uni Eropa, Anda harus mematuhi Kebijakan Izin Pengguna Uni Eropa. Kami telah menambahkan pemberitahuan terkait persyaratan ini di Persyaratan Layanan YouTube API.
17 Desember 2015
Update ini berisi perubahan berikut:
-
Resource dan metode baru
-
API ini mendukung beberapa resource baru guna mendukung fungsi chat untuk live streaming. YouTube mendukung fungsi live chat selama live streaming aktif. Referensi ini dan metodenya mendukung pengambilan pesan chat serta fungsi administratif untuk chat.
Referensi liveChatMessage
Referensi ini mewakili pesan dalam live chat YouTube. YouTube mendukung beberapa jenis pesan, termasuk pesan teks dan acara Fan Funding. Beberapa jenis pesan mengidentifikasi fase chat tertentu, misalnya awal periode khusus sponsor atau akhir chat. API mendukung metode untuk menampilkan daftar, menyisipkan, dan menghapus pesan live chat. liveChatModerators
Referensi ini mengidentifikasi moderator chat. Moderator dapat melakukan beberapa fungsi administratif, seperti memblokir pengguna dari chat atau menghapus pesan. API mendukung metode untuk menampilkan daftar, menyisipkan, dan menghapus moderator live chat. liveChatBans
Referensi ini mengidentifikasi pengguna yang diblokir agar tidak memposting pesan ke live chat tertentu. Pemblokiran dapat bersifat sementara atau permanen. API mendukung metode untuk menyisipkan dan menghapus pemblokiran live chat. fanFundingEvents
Referensi ini mewakili acara Fan Funding di channel YouTube. Fan Funding memberikan cara bagi penonton untuk mendukung Kreator YouTube secara sukarela dengan dukungan keuangan satu kali.
MetodefanFundingEvents.list
API mencantumkan acara Fan Funding channel. Acara Fan Funding yang dimulai melalui live chat selama live streaming milik channel juga memicu pesanfanFundingEvent
ke live chat siaran.
Pelajari lebih lanjut Fan Funding di Pusat Bantuan YouTube.sponsors
Referensi sponsor
mengidentifikasi sponsor channel YouTube. Sponsor membayar biaya bulanan untuk suatu channel. Jika ada, badge yang muncul di samping pesan sponsor di live chat channel dan sponsor juga dapat berpartisipasi dalam live chat khusus untuk sponsor channel.
Metodesponsors.list
API mencantumkan sponsor channel. Saat pengguna mendaftar untuk mensponsori channel selama live streaming milik channel tersebut, API juga akan menambahkan pesannewSponsorEvent
ke live chat siaran tersebut.
Pelajari sponsor lebih lanjut 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 apa yang Anda berikan:closedCaptionsDisabled
: Teks tertutup dinonaktifkan untuk live streaming.closedCaptionsHttpPost
: Anda akan mengirim 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 tidak digunakan lagi mulai 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 properticontentDetails.closedCaptionsType
keclosedCaptionsHttpPost
. - Menetapkan nilai properti ke
false
sama dengan menetapkan properticontentDetails.closedCaptionsType
keclosedCaptionsDisabled
.
-
Parameter
broadcastType
baru metodeliveBroadcasts.list
memungkinkan Anda memfilter respons API untuk menyertakan siaran peristiwa, siaran persisten, atau semua siaran.Siaran persisten adalah siaran yang selalu ada dan tidak terikat dengan peristiwa tertentu. Khususnya, siaran default channel adalah siaran tetap, dan dapat diakses melalui Dasbor Live di YouTube Creator Studio. Siaran channel lainnya adalah siaran peristiwa.
-
-
Kolom
status.healthStatus.configurationIssues[].type
resourceliveStream
melaporkan error status kesehatan baru berikut:Error audioTooManyChannels
Audio memiliki lebih dari dua channel, tetapi hanya satu (mono) atau dua channel (stereo) yang didukung. Perbaiki jumlah channel audio. frameRateHigh
Kecepatan 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 ini mendukung error baru berikut:
Detail error liveBroadcasts.update
Kode Respons HTTP forbidden (403)
Alasan closedCaptionsTypeModificationNotAllowed
Deskripsi Nilai contentDetails.closedCaptionsType
hanya dapat diubah jika siaran dalam statuscreated
atauready
.liveBroadcasts.update
Kode Respons HTTP invalidValue (400)
Alasan invalidEnableClosedCaptions
Deskripsi Di resource liveBroadcast, nilai properti contentDetails.enableClosedCaptions
tidak 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
liveChat
dan metodenya bersifat rahasia dan hanya dapat dilihat oleh partner YouTube tertentu.Referensi
liveChat
baru berisi komentar yang diposting selama live streaming di YouTube. API mendukung dua metode untuk resource ini:Metode liveChats.list
Mencantumkan pesan live chat untuk siaran. liveChats.insert
Buat 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 saluran. 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 streaming 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 kualitas streaming video live.
Secara khusus, objekstatus.healthStatus.configurationIssues[]
mencantumkan masalah yang memengaruhi streaming video. Dokumen baru, Configuration Issues for LiveStream Resources, mencantumkan semua masalah yang dilaporkan API.contentDetails.isReusable
Menunjukkan apakah streaming dapat digunakan kembali, artinya streaming dapat dikaitkan ke beberapa siaran. Penyiar umumnya menggunakan kembali streaming yang sama untuk berbagai siaran 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 saluran. Jika channel YouTube diaktifkan untuk live streaming, YouTube akan membuat streaming default dan siaran default untuk channel tersebut. Streaming menentukan cara pemilik channel mengirimkan video live ke YouTube, dan siaran adalah cara penonton melihat streaming default. Lihat definisi properti untuk informasi selengkapnya tentang cara kerja siaran default. contentDetails.enableLowLatency
Menunjukkan apakah siaran ini harus dienkode untuk streaming latensi rendah. Streaming berlatensi rendah dapat mengurangi jumlah waktu yang diperlukan video agar terlihat oleh pengguna yang menonton siaran, meskipun juga dapat memengaruhi resolusi bagi penonton streaming. statistics.totalChatCount
Jumlah total pesan live chat yang dikaitkan dengan siaran. Properti dan nilainya muncul jika siaran dapat dilihat oleh pengguna dan mengaktifkan fitur live chat. 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 ini mendukung error baru berikut:Detail error liveStreams.update
Kode Respons HTTP forbidden (403)
Alasan liveStreamModificationNotAllowed
Deskripsi API ini tidak memungkinkan Anda mengubah streaming yang dapat digunakan kembali menjadi tidak dapat digunakan kembali, atau sebaliknya. Untuk informasi selengkapnya, baca Memahami Siaran dan Streaming
-
21 Mei 2015
Update ini berisi perubahan berikut:
-
YouTube kini mendukung streaming video langsung pada kecepatan 60 frame per detik (fps), yang berarti pemutaran yang lebih lancar untuk bermain game dan video lainnya yang lebih cepat. Saat Anda memulai live stream di YouTube pada 60 fps, YouTube juga akan membuat streaming tersedia dalam 30 fps pada perangkat yang belum memiliki kemampuan menonton dengan kecepatan frame tinggi.
Properti
cdn.format
resourceliveStream
mendukung dua nilai baru untuk fitur ini:720p_hfr
dan1080p_hfr
.Baca Blog Kreator YouTube untuk mengetahui informasi lebih lanjut tentang fitur ini.
21 Agustus 2014
Update ini berisi perubahan berikut:
-
Definisi parameter
walltime
metodeliveBroadcasts.control
telah diperbarui untuk memperhatikan 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
danliveStream
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 tersedia di setelan channel pengguna di https://www.youtube.com/features.rateLimitExceeded
userRequestsExceedRateLimit
Metode liveBroadcasts.insert
danliveStreams.insert
menampilkan error ini untuk menunjukkan bahwa pengguna telah mengirim terlalu banyak permintaan dalam jangka waktu yang ditentukan.
2 Mei 2014
Update ini berisi perubahan berikut:
-
Deskripsi resource
liveStream
dan metodeliveBroadcasts.bind
telah diperbarui untuk menunjukkan bahwa siaran hanya dapat dikaitkan dengan satu streaming video, tetapi streaming video dapat dikaitkan dengan lebih dari satu siaran. Perubahan ini semata-mata koreksi untuk dokumentasi; fungsi API yang mendasarinya tidak berubah. -
Properti
contentDetails.monitorStream.enableMonitorStream
resourceliveBroadcast
telah diperbarui untuk menjelaskan bahwa jika nilai properti adalahtrue
, Anda harus mentransisikan siaran ke statustesting
sebelum dapat mentransisikannya ke statuslive
. (Jika nilai properti adalahfalse
, siaran Anda tidak boleh memiliki tahapantesting
, sehingga Anda dapat mentransisikan siaran langsung ke statuslive
. -
Properti
settings.offsetTimeMs
resourceliveCuepoint
telah diperbarui untuk memberikan catatan bahwa Anda tidak boleh menentukan nilai untuk properti jika siaran Anda tidak memiliki aliran data monitor. -
Semua metode untuk resource
liveBroadcast
danliveStream
sekarang mendukung parameteronBehalfOfContentOwner
danonBehalfOfContentOwnerChannel
. Parameter ini memungkinkan Anda menggunakan kredensial otorisasi yang sama untuk menyelesaikan permintaan API untuk berbagai saluran yang terkait dengan pemilik konten yang sama. -
Dokumentasi metode
liveCuepoints.insert
telah diperbarui untuk memperhatikan bahwa Anda dapat menetapkan nilai untuk propertisettings.walltime
saat memanggil metode tersebut. -
Dokumentasi error sekarang menentukan kode respons HTTP untuk setiap jenis error.
-
API ini sekarang mendukung error berikut:
Jenis error Detail error Deskripsi insufficientPermissions
livePermissionBlocked
Metode liveBroadcasts.insert
,liveBroadcasts.transition
, danliveStreams.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 tersedia di setelan channel pengguna di https://www.youtube.com/features. -
Error
invalidScheduledStartTime
metodeliveBroadcasts.insert
telah diperbarui untuk mengklarifikasi bahwa waktu mulai yang dijadwalkan harus cukup mendekati tanggal saat ini sehingga siaran dapat dijadwalkan dengan andal pada waktu itu.
13 Desember 2013
Update ini berisi perubahan berikut:
-
Properti
status.recordingStatus
baru resourceliveBroadcast
mengidentifikasi status siaran saat ini. -
Properti
contentDetails.enableClosedCaptions
baru pada resourceliveBroadcast
menunjukkan apakah teks tertutup dapat diserap untuk siaran. Nilai properti dapat ditetapkan saat Anda menyisipkan atau memperbarui siaran, tetapi tidak dapat diperbarui setelah siaran berada dalam statustesting
ataulive
. Jika Anda menyetel properti ini ketrue
, resourceliveStream
yang terikat dengan siaran akan menentukan URL proses transfer yang akan digunakan untuk teks tertutup siaran. -
Properti
snippet.scheduledEndTime
resourceliveBroadcast
kini mendukung siaran yang dijadwalkan untuk berlanjut tanpa batas. Dengan perubahan ini, properti tidak lagi diperlukan dalam permintaanliveBroadcasts.insert
danliveBroadcasts.update
.
Jika Anda mengambil resourceliveBroadcast
yang tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk dilanjutkan tanpa batas. Demikian pula, jika Anda memanggil metodeliveBroadcasts.insert
atauliveBroadcasts.update
dan tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk dilanjutkan tanpa batas. -
Properti
contentDetails.recordFromStart
resourceliveBroadcast
, yang sudah memiliki nilai defaulttrue
, sekarang hanya dapat ditetapkan kefalse
jika saluran siaran diizinkan menonaktifkan rekaman untuk live streaming.Jika channel Anda tidak memiliki izin untuk menonaktifkan perekaman, dan Anda mencoba menyisipkan siaran dengan properti
recordFromStart
yang disetel kefalse
, API akan menampilkan errorForbidden
. Selain itu, jika channel tidak memiliki izin tersebut dan Anda mencoba memperbarui siaran untuk menyetel propertirecordFromStart
kefalse
, API akan menampilkan errormodificationNotAllowed
. -
Resource
liveBroadcast
tidak lagi berisi propertienableArchive
, yang telah disebutkan dalam deskripsi properticontentDetails.enableDvr
dancontentDetails.enableEmbed
. -
Daftar nilai yang valid untuk properti
status.lifeCycleStatus
resourceliveBroadcast
telah diperbarui untuk menyertakan deskripsi setiap status. -
Properti
settings.walltime
baru resourceliveCuepoint
menentukan tanggal dan waktu saat titik tanda harus disisipkan. API menampilkan error jika permintaan mencoba menyisipkan titik tanda yang menentukan nilai untuk properti ini dan propertisettings.offsetTimeMs
. -
Objek
contentDetails
baru dalam resourceliveStream
berisi informasi tentang aliran data. Saat ini, satu-satunya properti objek adalahcontentDetails.closedCaptionsIngestionUrl
, yang menentukan URL proses transfer untuk teks tertutup yang terkait dengan streaming video. -
Daftar nilai yang valid untuk properti
status.streamStatus
resourceliveStream
telah diperbarui untuk menyertakan deskripsi setiap status. -
Parameter
walltime
baru metodeliveBroadcasts.control
memungkinkan Anda menentukan tanggal dan waktu saat perubahan slate akan terjadi. API menampilkan error jika permintaan menentukan nilai untuk parameter ini dan untuk parameteroffsetTimeMs
. -
Dalam respons API terhadap permintaan
liveBroadcasts.list
, nilai propertikind
telah diubah dariyoutube#liveBroadcastList
menjadiyoutube#liveBroadcastListResponse
. -
Dalam respons API terhadap permintaan
liveStreams.list
, nilai propertikind
telah diubah dariyoutube#liveStreamList
menjadiyoutube#liveStreamListResponse
. -
Properti
eventId
sudah tidak digunakan lagi dariliveBroadcastListResponse
danliveStreamListResponse
. -
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 parameteroffsetTimeMs
danwalltime
. Permintaan dapat menghilangkan kedua parameter atau menentukan nilai untuk salah satu dari dua parameter.invalidValue
invalidWalltime
Metode liveBroadcasts.control
menampilkan error ini jika nilai parameterwalltime
tidak valid.forbidden
enableClosedCaptionsModificationNotAllowed
Metode liveBroadcasts.update
menampilkan error ini jika Anda mencoba mengupdate nilaicontentDetails.enableClosedCaptions
dan status siaran bukancreated
atauready
.invalidValue
conflictingTimeFields
Metode liveCuepoints.insert
menampilkan error ini jika permintaan Anda menentukan nilai untuk propertisettings.offsetTimeMs
dansettings.walltime
. Permintaan dapat menghilangkan kedua properti atau menentukan nilai untuk salah satu dari dua properti.Selain itu, metode
liveStreams.update
tidak lagi mendukung errorcdnRequired
yang 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 sekarang menyediakan daftar YouTube API yang tunduk pada kebijakan penghentian layanan.
2 Mei 2013
Update ini berisi perubahan berikut:
-
Metode
liveBroadcasts.control
baru memungkinkan Anda mengubah setelan tampilan untuk slate yang ditampilkan di streaming siaran untuk siaran yang sedang berlangsung. Jika streaming siaran Anda tertunda, Anda juga dapat menggunakan metode ini untuk menentukan selisih waktu kapan perubahan slate yang diminta akan terjadi. -
Definisi properti berikut telah diperbarui untuk menjelaskan bahwa nilai properti harus ditetapkan jika Anda memperbarui bagian
contentDetails
resourceliveBroadcast
: -
status.streamStatus
resourceliveStream
tidak lagi mendukung nilaideleted
sebagai kemungkinan status streaming. -
Informasi yang ditampilkan API untuk banyak pesan error telah direvisi untuk menjelaskan dengan lebih baik penyebab 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
startWithSlateCuepoint
telah diganti namanya menjadistartWithSlate
. - Properti
enableArchive
telah diganti namanya menjadirecordFromStart
. - Objek
slateSettings
sudah tidak digunakan lagi dan dihapus dari dokumentasi. Pesan error yang terkait dengan objekslateSettings
atau propertinya juga telah dihapus. Terakhir, bagian "Menampilkan Slate" pada panduan Memulai telah dihapus.
- Properti
-
API ini tidak lagi mendukung kemampuan untuk menyisipkan slate in-stream menggunakan metode
liveCuepoints.insert
. Dokumen berikut telah diperbarui untuk mencerminkan perubahan ini:-
Halaman indeks, panduan Memulai, dan tutorial Kehidupan siaran tidak lagi menyebutkan fungsi ini.
-
Properti
settings.cueType
resourceliveCuepoint
tidak lagi mendukungslate
sebagai nilai properti. (Satu-satunya nilai yang didukung adalahad
. -
Properti
settings.eventState
resourceliveCuepoint
tidak digunakan lagi 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 sekarang dapat menampilkan beberapa error baru. Daftar di bawah ini mengidentifikasi error dan metode API yang mungkin menampilkan error tersebut:
liveBroadcasts.insert
– Waktu berakhir yang dijadwalkan untuk siaran harus setelah waktu mulai yang dijadwalkan.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
– Panjang judul cuplikan harus antara 1 dan 128 karakter.liveStreams.update
– Resource tidak berisi atau tidak menetapkan nilai untuk propertisnippet.title
.
-
Dokumentasi resource
liveStream
telah diperbarui untuk menunjukkan bahwa multicast dan WebM tidak mendukung metode penyerapan seperti yang ditunjukkan sebelumnya. Daftar format untuk properticdn.format
telah diperbarui, dan objekcdn.multicastIngestionInfo
serta properti turunannya telah dihapus dari dokumentasi resource. Selain itu,http
telah dihapus dari daftar nilaicdn.ingestionType
yang didukung.