REST Resource: adBreak.networks.customAssets.adBreaks

Kaynak: AdBreak

Canlı video etkinliğindeki bir reklam arası için reklam kararı vermek üzere kullanılan reklam arası meta verileri.

JSON gösterimi 
{
  "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)
  }
}
Alanlar
name

string

Yalnızca çıkış. Reklam arasının kaynak adı. Bu alan "networks//assets//adBreaks/" biçiminde olur.

network_code, bu içeriğin ait olduğu Google Ad Manager'daki ağ kodudur.

asset_key, Google Ad Manager'da reklam arasının oluşturulduğu Canlı Yayın Etkinliği'nin anahtarıdır.

adBreakId, reklam arasının anahtarıdır. YALNIZCA ÇIKIŞ.
createTime

string (Timestamp format)

Yalnızca çıkış. Reklam arasının oluşturulma zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
expectedDuration

string (Duration format)

Zorunlu. Beklenen ara süresi.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
customParams
(deprecated)

string

İsteğe bağlı. Ad Manager'daki özel ölçüt hedefleme için bu arayla ilgili reklam isteklerine dahil edilecek anahtar/değer çiftleri. Örnek: "key1=value&key2=value2,value22" Desteği sonlandırıldı: Lütfen "cust_params" anahtarını kullanarak cust_params'ı breakParams.ad_tag_params içinde ayarlayın.
scte35CueOut

string

İsteğe bağlı. Base64 kodlu scte35 işaret çıkışı verileri. splice_insert() veya time_signal() komutunu içerebilir. Örnekler: - time_signal() ile: "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==" - splice_insert() ile: "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
podTemplateName
(deprecated)

string

İsteğe bağlı. Google Ad Manager kapsül şablonu adı. Desteği sonlandırıldı: Lütfen "ptpln" anahtarını kullanarak breakParams.ad_tag_params içinde cust_params'i ayarlayın.
breakState

enum (BreakState)

Yalnızca çıkış. Reklam arasının mevcut durumu.
expectedStartTime

string (Timestamp format)

İsteğe bağlı. Reklam arasının beklenen başlangıç zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
expireDuration

string (Duration format)

İsteğe bağlı. Reklam arasının süresini expectedStartTime + expireDuration'da sona erdirir. expectedStartTime ayarlanmamışsa reklam arası, karar verme işlemi başladıktan sonra expireDuration süresi dolduğunda sona erer. Varsayılan: 30 dakika Minimum: 5 dakika Maksimum: 6 saat

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
breakSequence

string (int64 format)

Yalnızca çıkış. Reklam arasının videonun ortasında gösterilen reklam sırası kimliği. breakParams.ad_tag_params aracılığıyla mridx anahtarıyla açıkça belirtilmişse birden fazla reklam arası aynı breakSequence'e sahip olabilir. Bu işlem, iki GAM reklam arasını etkili bir şekilde bağlar.
breakParams

object (BreakParams)

İsteğe bağlı. Bu arayla ilgili reklam isteklerine eklenecek ara parametreleri.
matchParams

object (MatchParams)

İsteğe bağlı. API aracılığıyla oluşturulan bir reklam arasının, manifestteki bir reklam arasıyla nasıl eşleştirileceğini belirlemek için Stitched DAI'de kullanılır. Yeni bir ara algılandığında, bir etkinliğin SCHEDULED veya DECISIONED breakState'ine sahip tüm reklam aralarıyla eşleşme işlevi çalıştırılarak bir reklam arasının matchParams'indeki tüm ayarlanmış parametrelerin algılanan ara ile eşleşip eşleşmediği kontrol edilir. Aşağıdaki koşullardan biri karşılanırsa eşleşme gerçekleşir: 1. Reklam arasında bir matchParams alanı var ve bu alanda ayarlanan tüm parametreler yeni arayla eşleşiyor. 2. Reklam arası DECISIONED ve matchParams alanı yok.

Yanlışlıkla "tümüyle eşleşme" davranışını (boş ancak mevcut bir matchParams ile oluşur) önlemek için, ayarlanmışsa matchParams boş olamaz. Alan bir istekte varsa kendi alanlarından en az biri ayarlanmalıdır.

Reklam araları şu sırayla kontrol edilir: 1. matchParams ile, artan expectedStartTime ve artan createTime'a göre sıralanır. Burada, sıralandığında expectedStartTime'ı olmayan reklam aralarına öncelik verilir. 2. matchParams olmadan, artan expectedStartTime ve artan createTime'a göre sıralanır. Burada, sıralandığında expectedStartTime'ı olmayan reklam aralarına öncelik verilir.

Bekleyen tüm EABN'ler eşleşmezse DAI, bir sonraki kullanılabilir orta rulo dizinini kullanarak JIT karar verme davranışına geri döner.
servedBreak

object (ServedBreak)

Yalnızca çıkış. Bu, yayınlanan reklam arasının gerçek bilgilerini yansıtır. Yalnızca COMPLETE breakState içeren reklam araları için ayarlanır.

Yöntemler

create

 Canlı yayın içinde reklam arası oluşturmak için kullanılan API.

delete

 Canlı yayındaki reklam arasını silmek için kullanılan API.

get

 Canlı yayında reklam arası almak için kullanılan API.

list

 Canlı yayın içindeki reklam aralarını listeleyen API.

patch

 Canlı yayındaki bir reklam arasını güncellemek için kullanılan API.