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
liveBroadcast
kini berisi objekmonetizationDetails
. Kolom objek menunjukkan apakah penyisipan iklan otomatis diaktifkan untuk siaran dan menentukan informasi tambahan untuk menjadwalkan titik pemicu. - Parameter
part
metodeliveBroadcast.list
mendukung nilaimonetizationDetails
. - Metode
update
dapat 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.update
tidak lagi memerlukan nilai untuk ditentukan bagi kolom berikut:snippet.title
status.privacyStatus
Jika kolom ini tidak disertakan dalam permintaan, kolom tersebut tidak akan berubah.
1 November 2022
-
Metode
liveBroadcasts.cuepoint
baru 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.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
sebagai gantinya. -
Dokumentasi untuk metode
liveBroadcasts.control
telah dihapus. A pemberitahuan penghentian penggunaan untuk metode tersebut diposting pada September 2020.
1 Oktober 2022
Update ini berisi perubahan berikut:
-
Metode
liveBroadcasts.update
tidak lagi memerlukan nilai untuk ditentukan bagi kolom ini:contentDetails.enableContentEncryption
contentDetails.enableDvr
contentDetails.enableEmbed
contentDetails.recordFromStart
contentDetails.startWithSlate
Jika kolom ini tidak disertakan dalam permintaan, kolom tersebut tidak akan berubah.
-
Menghapus dokumentasi untuk kolom
liveBroadcast
yang 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 dan turunannya di resourceliveChatMessage
berisi informasi tentang acara Pemberian Hadiah Langganan. Demikian pula, propertisnippet.giftMembershipReceivedDetails
baru dan turunannya berisi informasi tentang peristiwa Menerima Langganan Hadiah.
15 September 2021
Update ini berisi perubahan berikut:
-
Properti
snippet.type
kini mendukung dua nilai baru:newSponsorEvent
memberMilestoneChatEvent
-
Properti
snippet.memberMilestoneChatDetails
baru dan turunannya di resourceliveChatMessage
berisi informasi tentang peristiwa Chat Pencapaian Pelanggan. Demikian pula, propertisnippet.newSponsorDetails
baru dan turunannya berisi informasi tentang acara Sponsor Baru.
1 Desember 2020
Metode liveBroadcasts.transition
API mendukung error 403
(Forbidden
) baru, yang menunjukkan bahwa pengguna
telah mengirim terlalu banyak permintaan dalam jangka waktu tertentu. Alasan error adalah userRequestsExceedRateLimit
.
21 September 2020
-
Definisi properti
status.madeForKids
resourceliveBroadcast
telah 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.selfDeclaredMadeForKids
ketrue
saat memanggil metodeliveBroadcasts.insert
untuk membuat siaran. -
Catatan: Perubahan ini mencakup pengumuman penghentian penggunaan dan pembaruan pada pengumuman penghentian penggunaan sebelumnya.
Metode
liveBroadcasts.control
tidak akan digunakan lagi pada atau setelah 1 Oktober 2020. Setelah tanggal tersebut, semua panggilan ke metode ini akan menampilkan error 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.control
akan dihentikan penggunaannya secara bersamaan.
17 Juli 2020
Catatan: Ini adalah pembaruan untuk pengumuman penghentian penggunaan sebelumnya.
Kolom cdn.format
resource liveStream
, yang tidak digunakan lagi pada April 2016, tidak akan didukung lagi mulai 17 Agustus 2020. Permintaan yang masih menggunakan kolom tersebut akan gagal mulai tanggal tersebut.
Jika kode Anda masih menggunakan kolom cdn.format
, kode tersebut harus diupdate untuk menentukan kecepatan frame dan resolusi secara terpisah, menggunakan properti cdn.frameRate
dan cdn.resolution
.
6 Juli 2020
Panduan 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
file
telah 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
liveBroadcast
kini 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.enableAutoStart
ataucontentDetails.enableAutoStop
ketrue
. -
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
liveStream
danliveBroadcast
default channel untuk melakukan streaming konten live di YouTube. Khususnya, ID siaran dan ID streaming yang terkait dengan siaran dan streaming persisten tidak akan lagi berfungsi untuk memulai siaran baru.Aplikasi Anda akan terpengaruh jika salah satu kondisi berikut benar:
- Fungsi ini memeriksa nilai properti
isDefaultBroadcast
liveBroadcast
resource. Properti ini tidak akan ditampilkan setelah tanggal penghentian penggunaan. - Fungsi ini memeriksa nilai properti
isDefaultStream
liveStream
resource. Properti ini tidak akan ditampilkan setelah tanggal penghentian penggunaan. - Metode ini memanggil
metode
liveBroadcasts.list
dan menetapkan nilai parameterbroadcastType
kepersistent
atauall
. Parameter ini akan dihentikan sebagai bagian dari perubahan ini. Mulai tanggal penghentian:- Jika nilai parameter
broadcastType
adalahpersistent
, maka metodeliveBroadcasts.list
tidak akan menampilkan hasil apa pun. - Jika nilai parameter
broadcastType
adalahall
, maka metodeliveBroadcasts.list
tidak 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
liveBroadcast
danliveStream
serta 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
liveBroadcast
mendukung dua properti baru untuk memungkinkan kreator dan penonton konten mengidentifikasi konten "dibuat untuk anak-anak":-
Properti
selfDeclaredMadeForKids
memungkinkan 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 resourceliveBroadcast
jika pemilik channel mengizinkan permintaan API. -
Properti
madeForKids
memungkinkan 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
channel
juga mendukung propertiselfDeclaredMadeForKids
danmadeForKids
baru.
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.list
untuk 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.list
untuk mengambil data tentang siaran tertentu atau untuk mengambil data tentang siaran pengguna saat ini.Anda dapat menggunakan link di bagian tersebut untuk mengisi APIs Explorer dengan nilai contoh untuk kasus penggunaan Anda atau untuk membuka APIs Explorer layar penuh dengan nilai 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.type
kini ditetapkan kesuperStickerEvent
untuk 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.isSuperStickerEvent
menunjukkan apakah pesan Super Chat juga merupakan Super Sticker. Jika ya, objeksnippet.superStickerMetadata
berisi 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.insert
telah diperbarui untuk mencerminkan fakta bahwa parameteronBehalfOfContentOwner
saat 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
hl
baru metodesuperChatEvents.list
memungkinkan Anda menentukan bahwa nilai propertisnippet.displayString
harus diformat sesuai dengan konvensi bahasa tertentu. Definisi properti tersebut juga telah diperbarui sebagaimana mestinya.Nilai parameter harus berupa kode bahasa yang disertakan dalam daftar yang ditampilkan oleh metode
i18nLanguages.list
. Nilai defaultnya 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
superChatEvent
baru 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.type
kini mendukung nilaisuperChatEvent
, yang menunjukkan bahwa resource menjelaskan Super Chat.Selain itu, properti
snippet.superChatDetails
baru dan turunannya di resourceliveChatMessage
berisi informasi tentang peristiwa Super Chat. -
Properti
cdn.resolution
resourceliveStream
kini 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 tersebut adalahinvalidEmbedSetting
daninvalidProjection
.
-
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.list
tidak akan lagi menampilkan pesan dengansnippet.type
fanFundingEvent
. 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 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
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 yang baru didukung. Sementara itu,
cdn.format
tetap 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 dapat menampilkan error jika nilai tidak sesuai.Perhatikan bahwa meskipun properti
cdn.format
tidak digunakan lagi, properti ini kini mendukung dua nilai baru,1440p
dan1440p_hfr
, untuk mencerminkan dukungan API untuk streaming 1440p pada 30 atau 60 frame per detik.
-
- Pembaruan resource
liveBroadcast
-
Resource
liveBroadcast
berisi properti baru berikut:Properti contentDetails.boundStreamLastUpdateTimeMs
Tanggal dan waktu saat 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 ini adalah360
danrectangular
. -
Definisi properti
statistics.totalChatCount
resourceliveBroadcast
telah diperbarui untuk mencatat bahwa nilai properti hanya muncul jika siaran memiliki setidaknya satu pesan chat.
-
- Pembaruan resource
liveChatMessage
-
Properti
snippet.type
mendukung dua nilai baru –messageDeletedEvent
danuserBannedEvent
– yang sesuai dengan properti baru yang dijelaskan dalam poin-poin berikut. Definisi propertisnippet.authorChannelId
juga telah diperbarui untuk menjelaskan apa yang diidentifikasi oleh nilai properti untuk jenis pesan baru ini. -
Resource
liveChatMessage
berisi properti baru berikut:Properti snippet.messageDeletedDetails
Objek ini berisi informasi tentang pesan yang dihapus oleh moderator chat. Objek hanya ada jika nilai properti snippet.type
adalahmessageDeletedEvent
.snippet.userBannedDetails
Objek 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.type
adalahuserBannedEvent
.
-
- Pembaruan resource
-
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 errornya 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 tidak valid dalam 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 dalam 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 menentukan nilai untuk salah satu dari tiga properti. - API menampilkan error
frameRateRequired
jika Anda menentukan nilai untukcdn.resolution
, tetapi tidak untukcdn.frameRate
. - API menampilkan error
resolutionRequired
jika Anda menentukan nilai untukcdn.frameRate
, tetapi tidak untukcdn.resolution
.
liveStreams.update
Metode liveStreams.update
menampilkan error403
(Forbidden
) jika permintaan mencoba mengubah nilai salah satu 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 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 liveChatMessage
Resource 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. liveChatModerators
Resource 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. liveChatBans
Resource ini mengidentifikasi pengguna yang dilarang memposting pesan ke live chat tertentu. Larangan dapat bersifat sementara atau permanen. API ini mendukung metode untuk menyisipkan dan menghapus larangan live chat. fanFundingEvents
Resource 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.list
API mencantumkan peristiwa Fan Funding channel. Acara Pendanaan dari Penggemar yang dimulai melalui live chat selama siaran live yang dimiliki oleh channel juga memicu pesanfanFundingEvent
ke live chat siaran.
Pelajari lebih lanjut Pendanaan dari Penggemar di Pusat Bantuan YouTube.sponsors
Resource sponsor
mengidentifikasi sponsor channel YouTube. Sponsor membayar biaya bulanan 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.list
API mencantumkan sponsor channel. Saat pengguna mendaftar untuk mensponsori channel selama siaran live yang dimiliki oleh channel tersebut, API juga menambahkan pesannewSponsorEvent
ke live chat siaran.
Pelajari lebih lanjut sponsor di Pusat Bantuan YouTube.
-
-
Pembaruan pada resource dan metode yang ada
-
Resource
liveBroadcast
berisi properti baru berikut:Properti snippet.liveChatId
ID untuk live chat YouTube siaran. Dengan ID ini, Anda dapat menggunakan metode resource liveChatMessage
untuk mengambil, menyisipkan, atau menghapus pesan chat. Anda juga dapat menambahkan atau menghapus moderator chat, melarang pengguna berpartisipasi dalam live chat, atau menghapus larangan yang ada.contentDetails.closedCaptionsType
Catatan: Properti ini menggantikan properti contentDetails.enableClosedCaptions
.
Properti ini menunjukkan apakah teks tertutup diaktifkan untuk siaran Anda dan, jika ya, jenis teks tertutup yang Anda berikan:closedCaptionsDisabled
: Teks tertutup dinonaktifkan untuk 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.enableClosedCaptions
Properti 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
true
setara dengan menetapkan properticontentDetails.closedCaptionsType
keclosedCaptionsHttpPost
. - Menetapkan nilai properti ke
false
setara dengan menetapkan properticontentDetails.closedCaptionsType
keclosedCaptionsDisabled
.
-
Parameter
broadcastType
baru pada metodeliveBroadcasts.list
memungkinkan 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[].type
resourceliveStream
melaporkan error status kondisi baru berikut:Error audioTooManyChannels
Audio ini memiliki lebih dari dua channel, tetapi hanya satu (mono) atau dua (stereo) channel yang didukung. Perbaiki jumlah channel audio. frameRateHigh
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 mendukung error baru berikut:
Detail error liveBroadcasts.update
Kode Respons HTTP forbidden (403)
Alasan closedCaptionsTypeModificationNotAllowed
Deskripsi Nilai contentDetails.closedCaptionsType
hanya dapat diubah saat siaran dalam statuscreated
atauready
.liveBroadcasts.update
Kode Respons HTTP invalidValue (400)
Alasan invalidEnableClosedCaptions
Deskripsi Dalam 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.Resource
liveChat
baru berisi komentar yang diposting selama siaran langsung di YouTube. API ini 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 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.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.
Khususnya, objekstatus.healthStatus.configurationIssues[]
mencantumkan masalah yang memengaruhi streaming video. Dokumen baru, Masalah Konfigurasi untuk Resource LiveStream, mencantumkan semua masalah yang dilaporkan API.contentDetails.isReusable
Menunjukkan apakah 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
liveBroadcast
berisi properti baru berikut:Properti snippet.isDefaultBroadcast
Menunjukkan 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.enableLowLatency
Menunjukkan 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.totalChatCount
Jumlah total pesan live chat yang terkait dengan siaran. Properti dan nilainya ada jika siaran dapat dilihat oleh pengguna dan fitur live chat diaktifkan. Perhatikan bahwa properti ini tidak akan menentukan nilai setelah siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah pesan chat untuk video yang diarsipkan dari siaran live yang telah selesai.
-
-
Error baru dan yang diperbarui
-
Selain error yang ditentukan untuk resource
liveChat
baru, API mendukung error baru berikut:Detail error liveStreams.update
Kode Respons HTTP forbidden (403)
Alasan liveStreamModificationNotAllowed
Deskripsi 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.format
resourceliveStream
mendukung dua nilai baru untuk fitur ini:720p_hfr
dan1080p_hfr
.Lihat Blog Kreator YouTube untuk mengetahui informasi selengkapnya tentang fitur ini.
21 Agustus 2014
Update ini berisi perubahan berikut:
-
Definisi parameter
walltime
metodeliveBroadcasts.control
telah 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 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 mungkin 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 tertentu.
2 Mei 2014
Update ini berisi perubahan berikut:
-
Deskripsi resource
liveStream
dan metodeliveBroadcasts.bind
telah diperbarui untuk mencatat bahwa siaran hanya dapat terikat ke satu streaming video, tetapi streaming video dapat terikat ke lebih dari satu siaran. Perubahan ini hanya berupa koreksi pada 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 dapat memiliki tahaptesting
, sehingga Anda dapat mentransisikan siaran langsung ke statuslive
. -
Properti
settings.offsetTimeMs
resourceliveCuepoint
telah diperbarui untuk mencatat bahwa Anda tidak boleh menentukan nilai untuk properti jika siaran Anda tidak memiliki aliran monitor. -
Semua metode untuk resource
liveBroadcast
danliveStream
kini mendukung parameteronBehalfOfContentOwner
danonBehalfOfContentOwnerChannel
. 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.insert
telah diperbarui untuk mencatat bahwa Anda dapat menetapkan nilai untuk propertisettings.walltime
saat memanggil metode tersebut. -
Dokumentasi error kini menentukan kode respons HTTP untuk setiap jenis error.
-
API kini mendukung error berikut:
Jenis error Detail error Deskripsi insufficientPermissions
livePermissionBlocked
Metode liveBroadcasts.insert
,liveBroadcasts.transition
, 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 mungkin tersedia di setelan channel pengguna di https://www.youtube.com/features. -
Error
invalidScheduledStartTime
metodeliveBroadcasts.insert
telah diperbarui untuk mengklarifikasi bahwa waktu mulai terjadwal harus cukup dekat dengan tanggal saat ini sehingga siaran dapat dijadwalkan dengan andal pada waktu tersebut.
13 Desember 2013
Update ini berisi perubahan berikut:
-
Properti
status.recordingStatus
baru resourceliveBroadcast
mengidentifikasi status siaran saat ini. -
Properti
contentDetails.enableClosedCaptions
baru resourceliveBroadcast
menunjukkan apakah teks tertutup dapat di-ingest untuk siaran. Nilai properti dapat ditetapkan saat Anda menyisipkan atau memperbarui siaran, tetapi tidak dapat diperbarui setelah siaran berada dalam statustesting
ataulive
. Jika Anda menyetel properti ini ketrue
, resourceliveStream
yang terikat ke siaran akan menentukan URL penyerapan 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 berlanjut tanpa batas waktu. Demikian pula, jika Anda memanggil metodeliveBroadcasts.insert
atauliveBroadcasts.update
dan tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk berlanjut tanpa batas. -
Properti
contentDetails.recordFromStart
resourceliveBroadcast
, yang sudah memiliki nilai defaulttrue
, kini hanya dapat disetel kefalse
jika 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
recordFromStart
yang ditetapkan kefalse
, API akan menampilkan errorForbidden
. Selain itu, jika channel Anda 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 valid untuk properti
status.lifeCycleStatus
resourceliveBroadcast
telah diperbarui untuk menyertakan deskripsi setiap status. -
Properti
settings.walltime
baru resourceliveCuepoint
menentukan 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
contentDetails
baru dalam resourceliveStream
berisi 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.streamStatus
resourceliveStream
telah diperbarui untuk menyertakan deskripsi setiap status. -
Parameter
walltime
baru metodeliveBroadcasts.control
memungkinkan 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 propertikind
telah berubah dariyoutube#liveBroadcastList
menjadiyoutube#liveBroadcastListResponse
. -
Dalam respons API terhadap permintaan
liveStreams.list
, nilai propertikind
telah berubah dariyoutube#liveStreamList
menjadiyoutube#liveStreamListResponse
. -
Properti
eventId
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 kedua 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 memperbarui 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 kedua properti tersebut.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 kini 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 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
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 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
startWithSlateCuepoint
telah diganti namanya menjadistartWithSlate
. - Properti
enableArchive
telah diganti namanya menjadirecordFromStart
. - Objek
slateSettings
telah dihentikan dan dihapus dari dokumentasi. Pesan error yang terkait dengan objekslateSettings
atau 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.cueType
resourceliveCuepoint
tidak lagi mendukungslate
sebagai nilai properti. (Satu-satunya nilai yang didukung adalahad
. -
Properti
settings.eventState
resourceliveCuepoint
telah 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
liveStream
telah diperbarui untuk mencerminkan bahwa multicast dan WebM bukan metode penyerapan yang didukung seperti yang ditunjukkan sebelumnya. Daftar format untuk properticdn.format
telah diperbarui sebagaimana mestinya, dan objekcdn.multicastIngestionInfo
serta properti turunannya telah dihapus dari dokumentasi resource. Selain itu,http
telah dihapus dari daftar nilaicdn.ingestionType
yang didukung.