Halaman ini mencantumkan perubahan YouTube Live Streaming API dan pembaruan dokumentasi. Berlangganan log perubahan ini.
9 Oktober 2023
Hanya untuk referensi, Anda dapat menemukan ID Stiker yang terkait dengan Super Stickers mana 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 ini kini mendukung cara baru untuk menyisipkan iklan ke siaran live. Selain
liveCuepoints
, yang memungkinkan Anda
menyisipkan jeda iklan secara manual ke dalam siaran, YouTube kini mendukung fitur untuk
menyisipkan jeda iklan midroll secara otomatis ke dalam siaran pada interval tetap.
Jika pemilik siaran mengaktifkan iklan otomatis, mereka dapat melihat aspek perilaku iklan berikut:
- panjang interval antar-jeda iklan mid-roll.
- strategi penjadwalan untuk titik tanda iklan. Titik tanda dapat disisipkan secara serentak untuk semua penonton atau waktu titik tanda dapat bervariasi dari penonton ke penonton. Strategi kedua memungkinkan YouTube menjadwalkan titik tanda dengan kecepatan yang lebih tinggi sehingga penonton dapat menerima titik tanda saat mereka memenuhi syarat untuk melakukannya.
- periode saat iklan midroll tidak ditampilkan; untuk fitur ini, pemilik siaran menentukan bahwa penyisipan iklan midroll 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 tanda. - 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 tersebut 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
-
Metode
liveBroadcasts.cuepoint
baru memungkinkan pemilik channel yang menjalankan siaran live di YouTube menyisipkan titik tanda ke dalam siaran tersebut, yang dapat memicu jeda iklan. Metode ini menggantikan metodeliveCuepoints.insert
, yang hanya memungkinkan partner konten YouTube untuk menyisipkan titik tanda ke 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
. -
Dokumentasi untuk metode
liveBroadcasts.control
telah dihapus. 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 yang ditentukan untuk kolom berikut: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 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 dari resourceliveChatMessage
dan turunannya berisi informasi tentang peristiwa Hadiah Langganan. Demikian pula, propertisnippet.giftMembershipReceivedDetails
yang baru dan turunannya 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 peristiwa Chat Pencapaian Pelanggan. Demikian pula, propertisnippet.newSponsorDetails
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 tersebut bersifat hanya baca. Hal ini tidak mencerminkan perubahan pada fungsi API.Untuk menetapkan live streaming sebagai ditujukan untuk anak-anak, setel properti
status.selfDeclaredMadeForKids
ketrue
saat memanggil metodeliveBroadcasts.insert
untuk membuat siaran. -
Catatan: Perubahan ini mencakup pengumuman penghentian penggunaan dan pembaruan untuk pengumuman penghentian penggunaan sebelumnya.
Metode
liveBroadcasts.control
tidak akan digunakan lagi pada atau setelah 1 Oktober 2020. Setelah tanggal tersebut, semua panggilan ke metode ini akan menampilkan error dilarang (403), dan metode tersebut nantinya akan dihapus sepenuhnya. Klien tetap dapat menerapkan slating mereka sendiri dengan menambahkan overlay ke video yang dikirim ke server transfer YouTube.Tanggal penghentian untuk pengumuman penghentian yang dibuat pada 16 April 2020, yang awalnya dijadwalkan pada 1 September 2020, telah diundur dan sekarang akan dilakukan pada atau setelah 1 Oktober 2020. Dengan demikian, fitur yang disertakan dalam pengumuman penghentian tersebut dan metode
liveBroadcasts.control
akan berhenti digunakan secara bersamaan.
17 Juli 2020
Catatan: Ini adalah pembaruan untuk pengumuman penghentian 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 diperbarui untuk menentukan
kecepatan frame dan resolusi secara terpisah, menggunakan
properti
cdn.frameRate
dan
cdn.resolution
.
6 Juli 2020
Panduan Menayangkan Konten YouTube Live melalui HLS telah diperbarui dengan beberapa perubahan:
- 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 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 berhenti melakukan streaming video di streaming video terikat.Dokumen masa aktif 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 penggunaan. Perubahan ini akan berlaku pada atau setelah 1 September 2020. Tanggal sebenarnya saat perubahan diterapkan disebut di bawah sebagai tanggal penghentian.
Update 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. Secara khusus, ID siaran dan ID streaming yang terkait dengan siaran dan streaming persisten tidak akan berfungsi lagi untuk memulai siaran baru.Aplikasi Anda akan terpengaruh jika salah satu hal berikut berlaku:
- Fungsi ini memeriksa nilai properti
isDefaultBroadcast
resourceliveBroadcast
. Properti ini tidak akan dikembalikan setelah tanggal penghentian penggunaan. - Fungsi ini memeriksa nilai properti
isDefaultStream
resourceliveStream
. Properti ini tidak akan ditampilkan setelah tanggal penghentian penggunaan. - Metode ini memanggil
metode
liveBroadcasts.list
dan menetapkan nilai parameterbroadcastType
kepersistent
atauall
. Parameter ini tidak akan digunakan lagi sebagai bagian dari perubahan ini. Mulai tanggal penghentian:- Jika nilai parameter
broadcastType
adalahpersistent
, metodeliveBroadcasts.list
tidak akan menampilkan hasil apa pun. - Jika nilai parameter
broadcastType
adalahall
, 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 streaming default dan siaran default untuk channel saat channel tersebut diaktifkan untuk live streaming. Streaming default ada tanpa batas waktu, tidak memiliki waktu mulai atau berakhir yang terkait, dan tidak dapat dihapus. Demikian pula, siaran default dianggap permanen. Dimensi ini selalu ada dan tidak terikat dengan peristiwa tertentu.
Mulai tanggal penghentian:
- YouTube tidak akan lagi membuat streaming dan siaran default. Daripada mengandalkan
resource default, klien API harus dapat membuat dan mengelola
resource
liveBroadcast
danliveStream
serta mengikat resource tersebut bersama-sama. - Jika siaran default dan streaming default channel aktif, artinya channel menggunakannya untuk siaran live pada saat penghentian penggunaan diterapkan, 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 ini berlaku, YouTube akan mengabaikan upaya untuk menggunakan resource tersebut untuk menyiarkan video.
Jika aplikasi Anda terpengaruh, lihat dokumen berikut, yang akan membantu Anda mengupdate aplikasi agar tetap berfungsi seperti yang diharapkan setelah perubahan ini:
- Panduan migrasi baru mencoba menjelaskan langkah-langkah yang mungkin perlu dilakukan developer di klien API yang saat ini menggunakan siaran dan streaming default.
- Panduan Siklus 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
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
. Lihat
histori revisi YouTube Data API untuk mengetahui informasi selengkapnya
tentang resource baru.
11 Maret 2020
Bagian Endpoint transfer
dalam panduan Menayangkan Konten YouTube Live melalui HLS telah diperbarui untuk
memperjelas proses yang harus digunakan encoder untuk menyelesaikan parameter value file=
saat membuat URL transfer utama dan cadangan.
4 Februari 2020
Panduan Mengirimkan Konten YouTube Live melalui HLS
telah diperbarui untuk menunjukkan 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 disebut YouTube sebagai "Dibuat untuk Anak-Anak". Pelajari lebih lanjut konten yang "Dibuat untuk Anak-Anak" di Pusat Bantuan YouTube.
-
Resource
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 live adalah konten yang ditujukan untuk anak-anak. Properti ini dapat disetel saat membuat siaran melalui metodeliveBroadcasts.insert
. Perhatikan bahwa properti ini hanya disertakan dalam respons API yang berisi resourceliveBroadcast
jika pemilik channel memberikan otorisasi pada permintaan API. -
Dengan properti
madeForKids
, setiap pengguna API dapat mengambil status "Dibuat untuk Anak-Anak" siaran. 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
baru.
Kami juga telah memperbarui Persyaratan Layanan untuk Layanan YouTube API dan Kebijakan Developer. Baca Persyaratan Layanan untuk Layanan YouTube API - Histori Revisi untuk mengetahui informasi selengkapnya. Perubahan pada Persyaratan Layanan dan Kebijakan Developer untuk Layanan API YouTube akan berlaku pada 10 Januari 2020 Waktu Pasifik.
20 Agustus 2019
Bagian Persyaratan pada panduan Mengirimkan Konten YouTube Live melalui HLS telah diperbarui dengan dua perubahan:
- Artikel ini menjelaskan bahwa praktik terbaiknya adalah menyertakan segmen yang diakui dan segmen yang belum selesai di setiap Playlist Media. Praktik ini mengurangi 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 diproses di setiap Playlist Media.
- Sekarang Anda harus mengirimkan Playlist Media untuk setiap Segmen Media. Hal ini memungkinkan server untuk memulihkan dengan cepat jika Playlist Media hilang. Praktik ini sebelumnya tercantum sebagai rekomendasi.
28 Juni 2019
YouTube kini mendukung proses transfer HLS. Oleh karena itu, properti ingestionType
resource liveStream
mendukung nilai baru hls
untuk mengidentifikasi streaming yang ditransfer ke YouTube menggunakan HLS.
Panduan Menayangkan Konten YouTube Live melalui HLS yang baru memberikan panduan untuk menggunakan HLS guna menstreaming 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 untuk setiap metode dengan lebih baik dan memberikan contoh kode dinamis berkualitas tinggi melalui widget API Explorer. Lihat dokumentasi metode
liveBroadcasts.list
untuk mengetahui contohnya. Kini ada dua elemen baru di halaman yang menjelaskan metode API:-
Widget APIs Explorer memungkinkan Anda memilih cakupan otorisasi, memasukkan contoh parameter dan nilai properti, lalu mengirim permintaan API yang sebenarnya dan melihat respons API yang sebenarnya. Widget juga menawarkan tampilan layar penuh yang menunjukkan 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 API Explorer dengan nilai contoh untuk kasus penggunaan Anda atau untuk membuka API Explorer layar penuh dengan nilai tersebut yang sudah terisi. Perubahan ini bertujuan untuk memudahkan Anda melihat contoh kode yang secara langsung berlaku untuk kasus penggunaan yang coba 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 dalam API Explorer, dan membuka API Explorer layar penuh untuk mendapatkan contoh kode dalam Java, JavaScript, PHP, dan Python.
Sehubungan dengan perubahan ini, halaman yang sebelumnya mencantumkan contoh kode yang tersedia untuk Java, PHP, dan Python telah dihapus.
25 Februari 2019
Dokumentasi resource liveChatMessage
dan superChatEvent
telah diperbarui untuk mencerminkan fakta bahwa kedua resource tersebut kini dapat berisi informasi tentang Super Stickers. Super Stickers adalah jenis pesan Super Chat yang menampilkan gambar. Seperti Super Chat lainnya, pesan Super Stickers dibeli oleh penggemar selama live stream YouTube.
- Dalam resource
liveChatMessage
, 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 Sticker. - Dalam resource
superChatEvent
, booleansnippet.isSuperStickerEvent
menunjukkan apakah pesan Super Chat juga merupakan Super Stickers. Jika ya, objeksnippet.superStickerMetadata
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 tahun 2017.
3 April 2017
Contoh kode Java baru telah ditambahkan yang menunjukkan cara mencantumkan, menyisipkan, dan menghapus pesan live chat. Contoh ini memanggil metode berikut:
13 Februari 2017
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
-
Metode
liveCuepoints.insert
telah diperbarui untuk mencerminkan fakta bahwa parameteronBehalfOfContentOwner
saat ini diperlukan. Selain itu, deskripsi metode telah diperbarui untuk menunjukkan 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 dari 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 bahwa perilaku defaultnya adalah memformat string tampilan seperti yang akan digunakan dalam bahasa Inggris. Misalnya, secara default, string diformat sebagai$1.00
, bukan$1,00
.
-
1 Februari 2017
Update ini berisi perubahan berikut:
-
Referensi 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 dengan dua cara:- Super Chat ditandai dengan warna.
- Super Chat tetap disematkan di ticker selama jangka waktu yang ditetapkan.
Warna Super Chat, jangka waktu Super Chat tetap disematkan di ticker, dan panjang pesan maksimum semuanya ditentukan oleh jumlah pembelian. Pusat Bantuan YouTube memiliki informasi selengkapnya tentang Super Chat.
API ini mendukung metode untuk mencantumkan peristiwa Super Chat untuk live stream channel dalam 30 hari sebelumnya. Metode tersebut juga menampilkan data tentang peristiwa Fan Funding (
fanFundingEvents
) dari live stream terakhir channel.
-
-
Pembaruan pada resource dan metode yang ada
-
Properti
snippet.type
kini mendukung nilaisuperChatEvent
, yang menunjukkan bahwa resource menjelaskan Super Chat.Selain itu, properti
snippet.superChatDetails
baru dari resourceliveChatMessage
dan turunannya berisi informasi tentang peristiwa 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 kedua error baru tersebut adalahinvalidEmbedSetting
daninvalidProjection
.
-
12 Januari 2017
Catatan: Ini adalah pengumuman penghentian penggunaan.
Sehubungan dengan rilis fitur Super Chat baru, YouTube tidak lagi menggunakan fitur Fan Funding, dan Fan Funding API akan dinonaktifkan pada 28 Februari 2017. Sejak 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 ("Persyaratan yang Diperbarui") yang baru dipublikasikan, yang dibahas secara mendetail di Blog YouTube Engineering and Developers, memberikan serangkaian pembaruan yang lengkap pada 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 dalam histori revisi untuk Persyaratan yang Diperbarui. Selain itu, perubahan mendatang pada Persyaratan yang Diperbarui atau 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. Oleh karena itu, properti ingestionType
resource liveStream
mendukung nilai baru dash
untuk mengidentifikasi streaming yang ditransfer ke YouTube menggunakan DASH.
Panduan Mengirim Konten YouTube Live melalui DASH yang baru memberikan panduan untuk menggunakan format Pengiriman DASH guna melakukan streaming data live di YouTube dari encoder. API ini dimaksudkan untuk membantu vendor encoder menambahkan dukungan pengiriman DASH ke produk mereka.
18 April 2016
Update ini berisi perubahan berikut:
-
Pembaruan pada resource dan metode yang ada
- Pembaruan resource
liveStream
-
YouTube kini mendukung streaming dengan resolusi 1440p pada 30 atau 60 frame per detik.
Selain itu, resource
liveStream
berisi properti baru untuk menentukan kecepatan frame dan resolusi data video masuk:Properti cdn.frameRate
Kecepatan frame data video masuk. Nilai yang valid adalah 30fps
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
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 tersebut, API mungkin menampilkan error jika nilainya 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.
-
liveBroadcast
pembaruan referensi-
Resource
liveBroadcast
berisi properti baru berikut:Properti contentDetails.boundStreamLastUpdateTimeMs
Tanggal dan waktu live stream yang direferensikan 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 menunjukkan bahwa nilai properti hanya muncul jika siaran memiliki minimal satu pesan chat.
-
- Pembaruan resource
liveChatMessage
-
Properti
snippet.type
mendukung dua nilai baru –messageDeletedEvent
danuserBannedEvent
– yang sesuai dengan properti baru yang dijelaskan dalam poin berbutir berikut. Definisi propertisnippet.authorChannelId
juga telah diperbarui untuk menjelaskan apa yang diidentifikasi 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 diblokir agar tidak dapat 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 akan 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 error-nya 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 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 ketiga properti tersebut. - API menampilkan error
frameRateRequired
jika Anda menentukan nilai untukcdn.resolution
, tetapi tidak untukcdn.frameRate
. - API akan menampilkan error
resolutionRequired
jika Anda menetapkan nilai untukcdn.frameRate
, tetapi bukancdn.resolution
.
liveStreams.update
Metode liveStreams.update
menampilkan error403
(Forbidden
) jika permintaan mencoba mengubah nilai salah satu properti non-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 di Persyaratan Layanan YouTube API.
17 Desember 2015
Update ini berisi perubahan berikut:
-
Referensi dan metode baru
-
API ini mendukung beberapa resource baru untuk mendukung fungsi chat untuk siaran live. 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 mewakili pesan dalam live chat YouTube. YouTube mendukung beberapa jenis pesan, termasuk pesan teks dan peristiwa Fan Funding. Beberapa jenis pesan mengidentifikasi fase tertentu dari chat, seperti awal periode khusus sponsor atau akhir chat. API ini mendukung metode untuk membuat daftar, 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
Referensi 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 mewakili acara Fan Funding di channel YouTube. Fan funding memberikan cara bagi penonton untuk secara sukarela mendukung Kreator YouTube dengan dukungan keuangan satu kali.
MetodefanFundingEvents.list
API mencantumkan acara Fan Funding dari channel. Acara Fan Funding yang dimulai melalui live chat selama siaran live yang dimiliki oleh channel juga memicu pesanfanFundingEvent
ke live chat siaran.
Pelajari lebih lanjut Fan Funding 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 tersedia.
Metodesponsors.list
API mencantumkan sponsor channel. Saat pengguna mendaftar untuk mensponsori channel selama siaran live yang dimiliki oleh channel tersebut, API juga akan menambahkan pesannewSponsorEvent
ke live chat siaran.
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, 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 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. Secara khusus, siaran default channel adalah siaran persisten, dan dapat diakses melalui Dasbor Live Stream di YouTube Creator Studio. Siaran lain di channel tersebut 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 kurang.%(framerate)s
-
Tanggal publikasi pembaruan dokumentasi sebelumnya telah dikoreksi.
-
Error baru dan yang diperbarui
-
Selain error yang ditentukan untuk resource baru yang tercantum di atas, API mendukung error baru berikut:
Detail error liveBroadcasts.update
Kode Respons 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 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:
-
Referensi 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 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 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 saluran ada tanpa batas waktu, tidak memiliki waktu mulai atau waktu berakhir yang terkait, 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, Masalah Konfigurasi untuk Resource LiveStream, mencantumkan semua masalah yang dilaporkan API.contentDetails.isReusable
Menunjukkan apakah streaming dapat digunakan kembali, yang berarti dapat terikat 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. Jika channel YouTube diaktifkan untuk live streaming, YouTube akan membuat streaming default dan siaran default untuk channel tersebut. Streaming menentukan cara pemilik channel mengirim video live ke YouTube, dan siaran merupakan cara penonton dapat melihat streaming default. Lihat definisi properti untuk mengetahui informasi selengkapnya tentang cara kerja siaran default. contentDetails.enableLowLatency
Menunjukkan apakah siaran ini harus dienkode untuk streaming latensi rendah. Streaming dengan latensi rendah dapat mengurangi waktu yang diperlukan agar video dapat dilihat oleh pengguna yang menonton siaran, meskipun hal ini juga dapat memengaruhi resolusi untuk penonton streaming. statistics.totalChatCount
Jumlah total pesan live chat yang terkait dengan siaran. Properti dan nilainya akan ada jika siaran dapat dilihat oleh pengguna dan fitur live chat diaktifkan. Perhatikan bahwa properti ini tidak akan menentukan nilai setelah siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah pesan chat untuk video yang diarsipkan dari live streaming yang telah selesai.
-
-
Error baru dan yang diperbarui
-
Selain error yang ditentukan untuk resource
liveChat
baru, API mendukung error baru berikut:Detail error liveStreams.update
Kode Respons HTTP forbidden (403)
Alasan liveStreamModificationNotAllowed
Deskripsi API tidak mengizinkan Anda mengubah streaming yang dapat digunakan kembali menjadi tidak dapat digunakan kembali, atau sebaliknya. Untuk informasi selengkapnya, lihat Memahami Siaran dan Streaming
-
21 Mei 2015
Update ini berisi perubahan berikut:
-
YouTube kini mendukung streaming video live dengan kecepatan 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 kecepatan 60 fps, YouTube juga akan menyediakan streaming dalam resolusi 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
.Baca Blog Kreator YouTube untuk mengetahui informasi lebih lanjut mengenai fitur ini.
21 Agustus 2014
Update ini berisi perubahan berikut:
-
Definisi parameter
walltime
metodeliveBroadcasts.control
telah diperbarui untuk menunjukkan 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 memberikan otorisasi pada permintaan API belum diaktifkan untuk melakukan streaming video live di YouTube. Detail yang menjelaskan alasan pengguna tidak dapat melakukan live streaming video 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 mengirimkan terlalu banyak permintaan dalam jangka waktu tertentu.
2 Mei 2014
Update ini berisi perubahan berikut:
-
Deskripsi resource
liveStream
dan metodeliveBroadcasts.bind
telah diperbarui untuk menunjukkan bahwa siaran hanya dapat terikat ke satu streaming video, tetapi streaming video dapat terikat ke lebih dari satu siaran. Perubahan ini hanya merupakan koreksi pada dokumentasi; fungsi API yang mendasarinya tidak berubah. -
Properti
contentDetails.monitorStream.enableMonitorStream
resourceliveBroadcast
telah diperbarui untuk menjelaskan bahwa jika nilai propertinya adalahtrue
, Anda harus mentransisikan siaran ke statustesting
sebelum dapat mentransisikan ke statuslive
. (Jika nilai properti adalahfalse
, siaran Anda tidak dapat memiliki tahaptesting
, sehingga Anda dapat mentransisikan siaran langsung ke statuslive
secara langsung. -
Properti
settings.offsetTimeMs
resourceliveCuepoint
telah diperbarui untuk menunjukkan bahwa Anda tidak boleh menentukan nilai untuk properti jika siaran Anda tidak memiliki streaming monitor. -
Semua metode untuk resource
liveBroadcast
danliveStream
kini mendukung parameteronBehalfOfContentOwner
danonBehalfOfContentOwnerChannel
. Dengan parameter ini, Anda dapat menggunakan kredensial otorisasi yang sama guna menyelesaikan permintaan API untuk berbagai channel yang terkait dengan pemilik konten yang sama. -
Dokumentasi metode
liveCuepoints.insert
telah diperbarui untuk menunjukkan 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
akan menampilkan error ini jika pengguna yang mengizinkan permintaan tersebut tidak dapat melakukan streaming video live di YouTube. Detail yang menjelaskan alasan pengguna tidak dapat melakukan live streaming video mungkin tersedia di setelan channel pengguna di https://www.youtube.com/features. -
Error
invalidScheduledStartTime
metodeliveBroadcasts.insert
telah diperbarui untuk memperjelas 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 dari resourceliveBroadcast
mengidentifikasi status siaran saat ini. -
Properti
contentDetails.enableClosedCaptions
baru resourceliveBroadcast
menunjukkan apakah teks tertutup dapat ditransfer untuk siaran. Nilai properti dapat ditetapkan saat Anda menyisipkan atau memperbarui siaran, tetapi tidak dapat diperbarui setelah siaran berada dalam statustesting
ataulive
. Jika Anda menetapkan properti ini ketrue
, resourceliveStream
yang terikat dengan 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 waktu. Dengan perubahan ini, properti tidak lagi diperlukan dalam permintaanliveBroadcasts.insert
danliveBroadcasts.update
.
Jika Anda mengambil resourceliveBroadcast
yang tidak menentukan nilai untuk properti ini, siaran 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 berlanjut tanpa batas waktu. -
Properti
contentDetails.recordFromStart
resourceliveBroadcast
, yang telah memiliki nilai defaulttrue
, sekarang hanya dapat disetel kefalse
jika saluran penyiaran diizinkan untuk menonaktifkan perekaman untuk live streaming.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 yang valid untuk properti
status.lifeCycleStatus
resourceliveBroadcast
telah diperbarui untuk menyertakan deskripsi setiap status. -
Properti
settings.walltime
baru dari resourceliveCuepoint
menentukan tanggal dan waktu saat titik tanda harus disisipkan. API akan menampilkan error jika permintaan mencoba menyisipkan titik tanda 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 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 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 dua parameter.invalidValue
invalidWalltime
Metode liveBroadcasts.control
akan 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
akan 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 error yang didukung 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 mengalihkan 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 offset waktu saat 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 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
diganti namanya menjadistartWithSlate
. - Properti
enableArchive
telah diganti namanya menjadirecordFromStart
. - Objek
slateSettings
tidak digunakan lagi dan dihapus dari dokumentasi. Pesan error yang terkait dengan objekslateSettings
atau propertinya juga telah dihapus. Terakhir, bagian "Menampilkan Papan" dalam panduan Memulai telah dihapus.
- Properti
-
API tidak lagi mendukung kemampuan untuk menyisipkan slate dalam streaming menggunakan metode
liveCuepoints.insert
. Dokumen berikut telah diperbarui untuk mencerminkan perubahan ini:-
Halaman indeks, panduan Memulai, dan tutorial Durasi 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 kini dapat menampilkan beberapa error baru. Daftar di bawah mengidentifikasi error dan metode API yang mungkin menampilkan error tersebut:
liveBroadcasts.insert
– Waktu berakhir terjadwal siaran harus setelah waktu mulai terjadwalnya.liveBroadcasts.insert
– Siaran menentukan status privasi yang tidak valid.liveBroadcasts.update
– Resource tidak berisi atau tidak menetapkan nilai untuk 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 bukan metode penyerapan yang didukung 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.