REST Resource: adBreak.networks.customAssets.adBreaks

Resource: AdBreak

Metadata jeda iklan yang digunakan untuk memutuskan iklan untuk jeda iklan dalam acara video live.

Representasi JSON 
{
  "name": string,
  "createTime": string,
  "expectedDuration": string,
  "customParams": string,
  "scte35CueOut": string,
  "podTemplateName": string,
  "breakState": enum (BreakState),
  "expectedStartTime": string,
  "expireDuration": string,
  "breakSequence": string,
  "breakParams": {
    object (BreakParams)
  },
  "matchParams": {
    object (MatchParams)
  },
  "servedBreak": {
    object (ServedBreak)
  }
}
Kolom
name

string

Hanya output. Nama resource Jeda Iklan. Kolom ini akan memiliki format "networks//assets//adBreaks/".

network_code adalah kode jaringan di Google Ad Manager yang memiliki konten ini.

asset_key adalah kunci Acara Live Stream di Google Ad Manager yang digunakan untuk membuat Jeda Iklan.

adBreakId adalah kunci Jeda Iklan. HANYA OUTPUT.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan Jeda Iklan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
expectedDuration

string (Duration format)

Wajib. Perkiraan durasi istirahat.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
customParams
(deprecated)

string

Opsional. Pasangan nilai kunci yang akan disertakan dalam permintaan iklan untuk jeda ini bagi penargetan kriteria kustom di Ad Manager. Contoh: 'key1=value&key2=value2,value22' Tidak digunakan lagi: Tetapkan cust_params di breakParams.ad_tag_params menggunakan kunci "cust_params".
scte35CueOut

string

Opsional. Data berenkode Base 64 dari cue out scte35. Dapat menyertakan perintah splice_insert() atau time_signal(). Contoh: - dengan time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - dengan splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
podTemplateName
(deprecated)

string

Opsional. Nama template pod Google Ad Manager. Tidak digunakan lagi: Tetapkan cust_params di breakParams.ad_tag_params menggunakan kunci "ptpln".
breakState

enum (BreakState)

Hanya output. Status Jeda Iklan saat ini.
expectedStartTime

string (Timestamp format)

Opsional. Perkiraan waktu mulai Jeda Iklan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
expireDuration

string (Duration format)

Opsional. Mengakhiri Jeda Iklan pada expectedStartTime + expireDuration. Jika expectedStartTime tidak disetel, Jeda Iklan akan berakhir expireDuration setelah pengambilan keputusan dimulai. Default: 30 menit Minimum: 5 menit Maksimum: 6 jam

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
breakSequence

string (int64 format)

Hanya output. ID urutan mid-roll Jeda Iklan. Beberapa jeda iklan dapat memiliki breakSequence yang sama jika ditentukan secara eksplisit melalui breakParams.ad_tag_params dengan kunci mridx. Hal ini secara efektif menautkan dua jeda iklan GAM.
breakParams

object (BreakParams)

Opsional. Parameter jeda yang akan disertakan dalam permintaan iklan untuk jeda ini.
matchParams

object (MatchParams)

Opsional. Digunakan untuk DAI yang Digabungkan untuk menentukan cara Jeda Iklan yang dibuat melalui API dicocokkan dengan jeda iklan dalam manifes. Saat jeda baru terdeteksi, fungsi pencocokan akan dijalankan terhadap semua jeda iklan dari peristiwa yang memiliki breakState SCHEDULED atau DECISIONED untuk memeriksa apakah semua parameter yang ditetapkan di matchParams Jeda Iklan cocok dengan jeda yang terdeteksi. Kecocokan terjadi jika salah satu kondisi berikut terpenuhi: 1. Istirahat Iklan memiliki kolom matchParams, dan semua parameter yang ditetapkan di dalamnya cocok dengan jeda baru. 2. Jeda Iklan adalah DECISIONED dan tidak memiliki kolom matchParams.

Untuk mencegah perilaku "mencocokkan semua" yang tidak disengaja (yang akan terjadi dengan matchParams yang kosong tetapi ada), matchParams tidak boleh kosong jika disetel. Jika kolom ada dalam permintaan, setidaknya salah satu kolomnya sendiri harus ditetapkan.

Jeda Iklan diperiksa dalam urutan ini: 1. dengan matchParams, diurutkan berdasarkan expectedStartTime menaik, createTime menaik, dengan Jeda Iklan tanpa expectedStartTime diprioritaskan saat diurutkan 2. tanpa matchParams, diurutkan berdasarkan expectedStartTime menaik, createTime menaik, dengan Jeda Iklan tanpa expectedStartTime diprioritaskan saat diurutkan

Jika semua EABN yang tertunda tidak cocok, DAI akan kembali ke perilaku pengambilan keputusan JIT menggunakan indeks midroll berikutnya yang tersedia
servedBreak

object (ServedBreak)

Hanya output. Hal ini mencerminkan informasi sebenarnya dari jeda iklan yang ditayangkan. Hanya ditetapkan untuk jeda iklan dengan COMPLETE breakState.

Metode

create

 API untuk membuat Jeda Iklan dalam live stream.

delete

 API untuk menghapus Jeda Iklan dalam live stream.

get

 API untuk mendapatkan Jeda Iklan dalam live stream.

list

 API untuk mencantumkan Jeda Iklan dalam live stream.

patch

 API untuk memperbarui Jeda Iklan dalam live stream.