LiveBroadcasts

API kini mendukung kemampuan untuk menandai siaran live Anda sebagai "dibuat untuk anak-anak", dan resource liveBroadcast kini berisi properti yang mengidentifikasi status "dibuat untuk anak-anak" dari siaran live tersebut. Persyaratan Layanan untuk Layanan API YouTube dan Kebijakan Developer juga diperbarui pada 10 Januari 2020. Untuk informasi selengkapnya, lihat histori revisi untuk Layanan YouTube Live Streaming API dan Persyaratan Layanan untuk Layanan YouTube API.

Resource liveBroadcast merepresentasikan acara yang akan di-streaming, menggunakan video live, di YouTube.

Metode

API ini mendukung metode berikut untuk resource liveBroadcasts:

list
Menampilkan daftar siaran YouTube yang cocok dengan parameter permintaan API. Coba sekarang.
insert
Membuat siaran. Coba sekarang.
update
Memperbarui siaran. Misalnya, Anda dapat mengubah setelan siaran yang ditentukan dalam objek contentDetails resource liveBroadcast. Coba sekarang.
hapus
Menghapus siaran. Coba sekarang.
ikat
Mengikat siaran YouTube ke streaming atau menghapus pengikatan yang ada antara siaran dan streaming. Siaran hanya dapat terikat ke satu streaming video, meskipun streaming video dapat terikat ke lebih dari satu siaran. Coba sekarang.
transition
Mengubah status siaran live streaming YouTube dan memulai proses apa pun yang terkait dengan status baru. Misalnya, saat Anda mengubah status siaran menjadi testing, YouTube akan mulai mentransmisikan video ke streaming monitor siaran tersebut. Sebelum memanggil metode ini, Anda harus mengonfirmasi bahwa nilai properti status.streamStatus untuk streaming yang terikat ke siaran Anda adalah active. Coba sekarang.
cuepoint
Menyisipkan titik cuplikan ke live streaming. Cuepoint dapat memicu jeda iklan.

Representasi resource

Struktur JSON berikut menunjukkan format resource liveBroadcasts:

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean,
    "availabilityConfig": {
      "globalConfig": {
        "excludedRegionCodes": [
          string
        ],
        "interval": {
          "startTime": datetime,
          "endTime": datetime
        }
      },
      "regionsConfig": {
        "regionIntervals": [
          {
            "regionCode": string,
            "interval": {
              "startTime": datetime,
              "endTime": datetime
            }
          }
        ]
      }
    }
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
    "adsMonetizationStatus": string,
    "eligibleForAdsMonetization": boolean,
    "cuepointSchedule": {
      "enabled": boolean,
      "pauseAdsUntil": datetime,
      "ytOptimizedCuepointConfig": string,
      "creatorCuepointConfig": {
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer
      }
    }
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#liveBroadcast.
etag etag
ETag resource ini.
id string
ID yang ditetapkan YouTube untuk mengidentifikasi siaran secara unik.
snippet object
Objek snippet berisi detail dasar tentang acara, termasuk judul, deskripsi, waktu mulai, dan waktu berakhirnya.
snippet.publishedAt datetime
Tanggal dan waktu siaran ditambahkan ke jadwal live streaming YouTube. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik channel yang memublikasikan siaran.
snippet.title string
Judul siaran. Perhatikan bahwa siaran ini mewakili tepat satu video YouTube. Anda dapat menyetel kolom ini dengan mengubah resource siaran atau dengan menyetel kolom title dari resource video yang sesuai.
snippet.description string
Deskripsi siaran. Seperti title, Anda dapat menyetel kolom ini dengan mengubah resource siaran atau dengan menyetel kolom description dari resource video yang sesuai.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan siaran. Untuk setiap objek bertingkat dalam objek ini, kuncinya adalah nama gambar mini, dan nilainya adalah objek yang berisi informasi lain tentang gambar mini.
snippet.thumbnails.(key) object
Nilai kunci yang valid adalah:
  • default – Gambar thumbnail default. Thumbnail default untuk video – atau konten yang merujuk ke video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel memiliki lebar 88 px dan tinggi 88 px.
  • medium – Versi gambar thumbnail dengan resolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320 px dan tinggi 180 px. Untuk channel, gambar ini berukuran lebar 240 piksel dan tinggi 240 piksel.
  • high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 480 px dan tinggi 360 px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
snippet.thumbnails.(key).url string
URL gambar.
snippet.thumbnails.(key).width unsigned integer
Lebar gambar.
snippet.thumbnails.(key).height unsigned integer
Tinggi gambar.
snippet.scheduledStartTime datetime
Tanggal dan waktu siaran dijadwalkan untuk dimulai. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Creator Studio mendukung kemampuan untuk membuat siaran tanpa menjadwalkan waktu mulai. Dalam hal ini, siaran dimulai setiap kali pemilik channel memulai streaming. Untuk siaran ini, nilai datetime sesuai dengan waktu epoch Unix nol, dan nilai ini tidak dapat diubah menggunakan API atau di Creator Studio.
snippet.scheduledEndTime datetime
Tanggal dan waktu yang dijadwalkan untuk mengakhiri siaran. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Jika resource liveBroadcast tidak menentukan nilai untuk properti ini, siaran akan dijadwalkan untuk berlanjut tanpa batas waktu. Demikian pula, jika Anda tidak menentukan nilai untuk properti ini, YouTube akan memperlakukan siaran seolah-olah akan berlangsung tanpa batas waktu.
snippet.actualStartTime datetime
Tanggal dan waktu saat siaran benar-benar dimulai. Informasi ini hanya tersedia setelah status siaran adalah live. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.actualEndTime datetime
Tanggal dan waktu siaran benar-benar berakhir. Informasi ini hanya tersedia setelah status siaran adalah complete. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.isDefaultBroadcast boolean
Properti ini tidak akan digunakan lagi pada atau setelah 1 September 2020. Pada saat itu, YouTube akan berhenti membuat streaming default dan siaran default saat channel diaktifkan untuk live streaming. Lihat pengumuman penghentian penggunaan untuk mengetahui detail selengkapnya.
Properti ini menunjukkan apakah siaran ini adalah siaran default.

Cara kerja siaran default

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. Pemilik channel dapat menggunakan metode liveStreams.list dan liveBroadcasts.list untuk mengidentifikasi resource ini.

Saat channel mulai melakukan streaming video ke streaming defaultnya, video tersebut akan terlihat di siaran default channel. Saat streaming berakhir, YouTube akan mengonversi siaran yang telah selesai menjadi video YouTube dan menetapkan ID video YouTube untuk video tersebut.

Setelah konversi selesai, video akan disertakan dalam daftar video yang diupload di channel. Video tidak langsung tersedia setelah siaran berakhir, dan durasi penundaan terkait dengan durasi siaran yang sebenarnya.
snippet.liveChatId string
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.
status object
Objek status berisi informasi tentang status acara.
status.lifeCycleStatus string
Status siaran. Status dapat diperbarui menggunakan metode liveBroadcasts.transition API.

Nilai yang valid untuk properti ini adalah:
  • complete – Siaran telah selesai.
  • created – Siaran memiliki setelan yang tidak lengkap, sehingga belum siap untuk bertransisi ke status live atau testing, tetapi telah dibuat dan valid.
  • live – Siaran aktif.
  • liveStarting – Siaran sedang dalam proses transisi ke status live.
  • ready – Setelan siaran sudah selesai dan siaran dapat bertransisi ke status live atau testing.
  • revoked – Siaran ini dihapus oleh tindakan administrator.
  • testStarting – Siaran sedang dalam proses transisi ke status testing.
  • testing – Siaran hanya dapat dilihat oleh partner.
status.privacyStatus string
Status privasi siaran. Perhatikan bahwa siaran ini merepresentasikan tepat satu video YouTube, sehingga setelan privasinya identik dengan setelan yang didukung untuk video. Selain itu, Anda dapat menyetel kolom ini dengan mengubah resource siaran atau dengan menyetel kolom privacyStatus dari resource video yang sesuai.

Nilai yang valid untuk properti ini adalah:
  • private
  • public
  • unlisted
status.recordingStatus string
Status rekaman siaran.

Nilai yang valid untuk properti ini adalah:
  • notRecording
  • recorded
  • recording
status.madeForKids boolean
Nilai ini menunjukkan apakah siaran ditetapkan sebagai ditujukan untuk anak-anak. Nilai properti ini bersifat hanya baca.
status.selfDeclaredMadeForKids boolean
Dalam permintaan liveBroadcasts.insert, properti ini memungkinkan pemilik channel menetapkan siaran sebagai ditujukan untuk anak-anak. Dalam permintaan liveBroadcasts.list, nilai properti hanya ditampilkan jika pemilik channel mengizinkan permintaan API.
contentDetails object
Objek contentDetails berisi informasi tentang konten video acara, seperti apakah konten dapat ditampilkan di pemutar video sematan atau apakah konten akan diarsipkan dan oleh karena itu tersedia untuk ditonton setelah acara selesai.
contentDetails.boundStreamId string
Nilai ini secara unik mengidentifikasi live stream yang terikat pada siaran.
contentDetails.boundStreamLastUpdateTimeMs datetime
Tanggal dan waktu saat livestream yang dirujuk oleh boundStreamId terakhir diperbarui.
contentDetails.monitorStream object
Objek monitorStream berisi informasi tentang aliran monitor, yang dapat digunakan penyiar untuk meninjau konten acara sebelum aliran siaran ditampilkan secara publik.
contentDetails.monitorStream.enableMonitorStream boolean
Nilai ini menentukan apakah streaming monitor diaktifkan untuk siaran. Jika streaming monitor diaktifkan, YouTube akan menyiarkan konten acara di streaming khusus yang ditujukan hanya untuk konsumsi penyiar. Penyiar dapat menggunakan streaming untuk meninjau konten acara dan juga untuk mengidentifikasi waktu yang optimal untuk menyisipkan titik cue.

Anda harus menyetel nilai ini ke true jika ingin memiliki tahap testing untuk siaran atau jika ingin memiliki penundaan siaran untuk acara. Selain itu, jika nilai properti ini adalah true, Anda harus mengalihkan siaran ke status testing sebelum dapat mengalihkannya ke status live. (Jika nilai properti adalah false, siaran Anda tidak dapat memiliki tahap testing, sehingga Anda dapat mentransisikan siaran langsung ke status live.)

Saat Anda update a broadcast, properti ini harus ditetapkan jika permintaan API Anda menyertakan bagian contentDetails dalam nilai parameter part. Namun, saat Anda insert a broadcast, properti bersifat opsional dan memiliki nilai default true.

Penting: Properti ini tidak dapat diperbarui setelah siaran berada dalam status testing atau live.
contentDetails.monitorStream.broadcastStreamDelayMs unsigned integer
Jika Anda telah menetapkan properti enableMonitorStream ke true, properti ini akan menentukan durasi penundaan siaran langsung.

Saat Anda update a broadcast, properti ini harus ditetapkan jika permintaan API Anda menyertakan bagian contentDetails dalam nilai parameter part. Namun, saat Anda insert a broadcast, properti bersifat opsional dan memiliki nilai default 0. Nilai ini menunjukkan bahwa siaran tidak memiliki penundaan siaran. Catatan: Properti ini tidak dapat diperbarui setelah siaran berada dalam status testing atau live.
contentDetails.monitorStream.embedHtml string
Kode HTML yang menyematkan pemutar yang memutar streaming monitor.
contentDetails.enableEmbed boolean
Setelan ini menunjukkan apakah video siaran dapat diputar di pemutar tersemat. Jika Anda memilih untuk mengarsipkan video (menggunakan properti enableArchive), setelan ini juga akan berlaku untuk video yang diarsipkan.

Saat Anda update a broadcast, properti ini harus ditetapkan jika permintaan API Anda menyertakan bagian contentDetails dalam nilai parameter part. Namun, saat Anda insert a broadcast, properti bersifat opsional dan memiliki nilai default true.

Catatan: Properti ini tidak dapat diperbarui setelah siaran berada dalam status testing atau live.
contentDetails.enableDvr boolean
Setelan ini menentukan apakah penonton dapat mengakses kontrol DVR saat menonton video. Kontrol DVR memungkinkan penonton mengontrol pengalaman pemutaran video dengan menjeda, memundurkan, atau mempercepat konten. Nilai default untuk properti ini adalah true.

Saat Anda update a broadcast, properti ini harus ditetapkan jika permintaan API Anda menyertakan bagian contentDetails dalam nilai parameter part. Namun, saat Anda insert a broadcast, properti bersifat opsional dan memiliki nilai default true.

Penting: Anda harus menetapkan nilai ke true dan juga menetapkan nilai properti enableArchive ke true jika ingin membuat pemutaran tersedia segera setelah siaran berakhir. Selain itu, properti ini tidak dapat diperbarui setelah siaran dalam status testing atau live.
contentDetails.recordFromStart boolean
Setelan ini menunjukkan apakah YouTube akan otomatis mulai merekam siaran setelah status acara berubah menjadi live.

Nilai default properti ini adalah true, dan hanya dapat disetel ke false jika channel 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 ke false, API akan menampilkan error Forbidden. Selain itu, jika channel Anda tidak memiliki izin tersebut dan Anda mencoba memperbarui siaran untuk menyetel properti recordFromStart ke false, API akan menampilkan error modificationNotAllowed.

Saat Anda update a broadcast, properti ini harus ditetapkan jika permintaan API Anda menyertakan bagian contentDetails dalam nilai parameter part. Namun, saat Anda insert a broadcast, properti bersifat opsional dan memiliki nilai default true.

Penting: Anda juga harus menetapkan nilai properti enableDvr ke true jika ingin pemutaran tersedia segera setelah siaran berakhir. Jika Anda menyetel nilai properti ini ke true, tetapi tidak menyetel properti enableDvr ke true, mungkin ada penundaan sekitar satu hari sebelum video yang diarsipkan tersedia untuk diputar.

Catatan: Properti ini tidak dapat diperbarui setelah siaran berada dalam status testing atau live.
contentDetails.enableClosedCaptions boolean
Properti ini sudah tidak digunakan lagi mulai 17 Desember 2015. Sebagai gantinya, gunakan properti contentDetails.closedCaptionsType.

Setelan ini menunjukkan apakah teks tertutup HTTP POST diaktifkan untuk siaran ini. Untuk klien API yang sudah menggunakan properti ini:
  • Menetapkan nilai properti ke true setara dengan menetapkan properti contentDetails.closedCaptionsType ke closedCaptionsHttpPost.
  • Menetapkan nilai properti ke false setara dengan menetapkan properti contentDetails.closedCaptionsType ke closedCaptionsDisabled.
contentDetails.closedCaptionsType string
Catatan: Properti ini menggantikan properti contentDetails.enableClosedCaptions.

Properti ini menunjukkan apakah teks tertutup diaktifkan untuk siaran Anda dan, jika ya, jenis teks tertutup apa yang Anda berikan:
  • closedCaptionsDisabled: Teks tertutup dinonaktifkan untuk live streaming.
  • closedCaptionsHttpPost: Anda akan mengirimkan teks, menggunakan HTTP POST, ke URL penyerapan yang terkait dengan livestream Anda.
  • closedCaptionsEmbedded: Teks akan dienkode dalam aliran video menggunakan format EIA-608 dan/atau CEA-708.
contentDetails.projection string
Format proyeksi siaran ini. Nilai default properti adalah rectangular.

Nilai yang valid untuk properti ini adalah:
  • 360
  • rectangular
contentDetails.enableLowLatency boolean
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.
contentDetails.latencyPreference string
Menunjukkan setelan latensi yang akan digunakan untuk siaran ini. Properti ini dapat digunakan sebagai pengganti enableLowLatency, yang tidak mendukung ultraLow.

Streaming latensi rendah dapat mengurangi waktu yang diperlukan agar video dapat dilihat oleh pengguna yang menonton siaran, meskipun juga dapat memengaruhi kelancaran pemutaran.

Streaming latensi ultra-rendah lebih mengurangi waktu yang diperlukan agar video dapat dilihat oleh penonton, sehingga mempermudah interaksi dengan penonton, tetapi latensi ultra-rendah tidak mendukung teks tertutup, atau resolusi yang lebih tinggi dari 1080p.

Nilai yang valid untuk properti ini adalah:
  • normal
  • low
  • ultraLow
contentDetails.enableAutoStart boolean
Menunjukkan apakah siaran ini harus dimulai secara otomatis saat Anda mulai melakukan streaming video di live stream yang terikat.
contentDetails.enableAutoStop boolean
Menunjukkan apakah siaran ini harus berhenti secara otomatis sekitar satu menit setelah pemilik channel berhenti melakukan streaming video di aliran video yang terikat.
contentDetails.availabilityConfig object
Konfigurasi ketersediaan siaran. Digunakan untuk menetapkan ketersediaan wilayah tertentu atau memblokir wilayah tertentu. Opsional - jika tidak disetel, tidak akan diterapkan.
contentDetails.availabilityConfig.globalConfig object
Konfigurasi ketersediaan global siaran. Video tersedia di semua wilayah, kecuali yang ditentukan dalam daftar excludedRegionCodes.
contentDetails.availabilityConfig.globalConfig.excludedRegionCodes list (string)
Daftar wilayah tempat video diblokir.
contentDetails.availabilityConfig.globalConfig.interval object
Rentang waktu default saat video tersedia untuk semua wilayah yang tidak diblokir. Catatan: Properti ini tidak didukung untuk siaran live mendatang atau aktif.
contentDetails.availabilityConfig.globalConfig.interval.startTime datetime
Tanggal dan waktu video tersedia. Jika tidak ditentukan, video sudah tersedia. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
contentDetails.availabilityConfig.globalConfig.interval.endTime datetime
Tanggal dan waktu video berhenti tersedia. Jika tidak ditentukan, video akan tersedia selamanya. Waktu mulai dan waktu berakhir yang ditentukan tidak boleh lebih dari lima tahun ke depan. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
contentDetails.availabilityConfig.regionsConfig object
Konfigurasi ketersediaan regional siaran. Video hanya tersedia di wilayah yang ditentukan.
contentDetails.availabilityConfig.regionsConfig.regionIntervals list (object)
Daftar wilayah dan jangka waktu video tersedia. Jika suatu wilayah ditentukan beberapa kali, gabungan semua interval akan digunakan.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.regionCode string
Wilayah tempat video tersedia.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval object
Periode waktu saat video tersedia untuk wilayah tertentu. Catatan: Properti ini tidak didukung untuk siaran live mendatang atau aktif.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.startTime datetime
Tanggal dan waktu video tersedia di wilayah yang ditentukan. Jika tidak ditentukan, video sudah tersedia. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.endTime datetime
Tanggal dan waktu video berhenti tersedia di wilayah yang ditentukan. Jika tidak ditentukan, video akan tersedia selamanya. Waktu mulai dan waktu berakhir yang ditentukan tidak boleh lebih dari lima tahun ke depan. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
statistics object
Objek statistics berisi statistik terkait siaran langsung. Nilai untuk statistik ini dapat berubah selama siaran dan hanya dapat diambil saat siaran sedang berlangsung.
statistics.totalChatCount unsigned long
Jumlah total pesan live chat yang terkait dengan siaran. Properti dan nilainya ada jika siaran terlihat oleh pengguna, mengaktifkan fitur chat langsung, dan memiliki setidaknya satu pesan. 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.
monetizationDetails object
Objek monetizationDetails berisi informasi tentang detail monetisasi streaming, seperti apakah pengotomatis iklan diaktifkan atau apakah penyisipan iklan mid-roll ditunda.

monetizationDetails.adsMonetizationStatus string
Properti ini menunjukkan apakah iklan mid-roll diaktifkan untuk siaran video. Nilai yang valid adalah on dan off.
monetizationDetails.eligibleForAdsMonetization string
Properti ini menunjukkan apakah siaran video memenuhi syarat untuk iklan mid-roll. Siaran mungkin tidak memenuhi syarat karena berbagai alasan, seperti adanya klaim yang sudah ada atau channel belum disiapkan untuk monetisasi.
monetizationDetails.cuepointSchedule object
Objek cuepointSchedule menentukan setelan otomatisasi iklan untuk siaran.
monetizationDetails.cuepointSchedule.enabled boolean
Nilai ini menentukan apakah iklan disisipkan secara otomatis dalam siaran. Jika nilainya adalah true, YouTube akan otomatis menyisipkan iklan mid-roll ke dalam siaran. Jadwal untuk menjalankan iklan akan ditentukan oleh nilai kolom lain dalam objek monetizationDetails.cuepointSchedule.
monetizationDetails.cuepointSchedule.pauseAdsUntil datetime
Nilai ini menentukan bahwa YouTube tidak boleh menyisipkan iklan mid-roll ke dalam siaran hingga tanggal dan waktu yang ditentukan. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ). Nilai harus ditetapkan ke tanggal dan waktu mendatang untuk menjeda iklan; nilai kolom juga dapat ditetapkan ke tanggal dan waktu lampau atau nilai kosong untuk melanjutkan iklan.
monetizationDetails.cuepointSchedule.ytOptimizedCuepointConfig string
Kolom ini menentukan opsi yang dipilih untuk titik pemicu iklan yang disisipkan secara otomatis. Kolom dapat menentukan salah satu dari tiga mode:
  • LOW: Potensi penghasilan lebih rendah, pengalaman penonton tidak terlalu terganggu
  • MEDIUM: Potensi penghasilan sedang, pengalaman penonton seimbang
  • HIGH: Potensi penghasilan lebih tinggi, pengalaman penonton lebih terganggu
monetizationDetails.cuepointSchedule.creatorCuepointConfig object
Objek creatorCuepointConfig menentukan opsi otomatisasi iklan, yang memungkinkan kreator memilih cara iklan mid-roll ditampilkan.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.scheduleStrategy string
Nilai ini menentukan strategi yang harus diikuti YouTube untuk menjadwalkan titik cue. Nilai yang valid adalah:
  • CONCURRENT: Cuepoint dijadwalkan pada waktu yang sama untuk semua penonton
  • NON_CONCURRENT: Cuepoint dijadwalkan pada waktu yang berbeda untuk penonton yang berbeda. Dengan pendekatan ini, iklan dapat ditampilkan dengan rasio yang lebih tinggi sehingga penonton dapat menerima titik cuplikan jika memenuhi syarat.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.repeatIntervalSecs unsigned integer
Nilai ini menentukan interval, dalam detik, antara penyisipan iklan otomatis selama siaran. Misalnya, jika nilainya adalah 360, YouTube dapat menyisipkan titik cuplikan iklan mid-roll pada interval enam menit.

Catatan:
  • Nilai menentukan waktu antara awal titik cu berurutan. Artinya, interval tidak diukur dari akhir satu titik isyarat ke awal titik isyarat berikutnya.
  • Agar konsisten dengan setelan YouTube Studio, nilai ini adalah kelipatan 6 menit dari 6 menit hingga 30 menit. Setiap bilangan bulat dalam permintaan pembaruan dalam rentang ini, meskipun valid, akan dibulatkan ke bawah ke kelipatan 6 menit terdekat.