LiveCuepoints

Resource liveCuepoint dan metode liveCuepoints.insert tidak digunakan lagi dan diganti dengan metode liveBroadcasts.cuepoint.

Resource liveCuepoint menyisipkan titik tanda dalam streaming video siaran, yang dapat memicu jeda iklan.

Catatan: Perintah API ini sebenarnya adalah bagian dari YouTube Content ID API dan memiliki persyaratan otorisasi yang berbeda dengan permintaan untuk mengelola resource liveBroadcast dan liveStream.

Metode

API mendukung metode berikut untuk resource liveCuepoints:

masukkan
Menyisipkan titik tanda ke live streaming. Saat ini, permintaan untuk metode ini harus diizinkan oleh akun yang terkait dengan Pemilik Konten YouTube. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource liveCuepoints:

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
id string
Nilai yang ditetapkan YouTube untuk mengidentifikasi titik tanda secara unik.
kind string
Jenis resource API. Untuk resource liveCuepoint, nilainya adalah youtubePartner#liveCuepoint.
broadcastId string
ID yang ditetapkan YouTube untuk mengidentifikasi siaran unik tempat titik tanda disisipkan.
settings object
Objek settings menentukan setelan titik tanda.
settings.offsetTimeMs long
Nilai ini menentukan titik waktu dalam video saat penonton akan melihat iklan atau slate in-stream. Nilai properti mengidentifikasi perbedaan waktu, dalam milidetik, dari awal aliran monitor. Meskipun diukur dalam milidetik, nilainya sebenarnya merupakan perkiraan, dan YouTube akan menyisipkan titik tanda sedekat mungkin dengan waktu tersebut. Anda tidak boleh menentukan nilai untuk parameter ini jika siaran Anda tidak memiliki streaming monitor.

Nilai default properti ini adalah 0, yang menunjukkan bahwa titik tanda harus disisipkan sesegera mungkin. Jika streaming siaran Anda tidak tertunda, maka 0 juga satu-satunya nilai yang valid. Namun, jika streaming siaran Anda tertunda, nilai properti dapat menentukan waktu saat titik tanda harus disisipkan. Lihat panduan Memulai untuk detail selengkapnya.

Catatan: Jika siaran Anda memiliki fase pengujian, offset diukur dari saat fase pengujian dimulai.
settings.walltime datetime
Nilai ini menentukan waktu jam dinding tempat titik tanda harus dimasukkan. Nilai ditetapkan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

API menampilkan error jika permintaan mencoba menyisipkan titik tanda yang menentukan nilai untuk properti ini dan untuk properti settings.offsetTimeMs.
settings.cueType string
Jenis titik tanda. Lihat panduan Memulai untuk mendapatkan penjelasan tentang berbagai jenis titik tanda. Lihat juga dokumen Masa aktif siaran untuk praktik terbaik tentang menyisipkan titik tanda selama siaran.

Nilai yang valid untuk properti ini adalah:
  • ad
settings.durationSecs unsigned integer
Durasi titik tanda, dalam detik. Nilai ini harus ditentukan jika cueType adalah ad dan diabaikan jika tidak.