REST Resource: adBreak.networks.customAssets.adBreaks

منبع: AdBreak

فراداده‌های پخش آگهی که برای تصمیم‌گیری در مورد پخش آگهی در یک رویداد ویدیویی زنده استفاده می‌شوند.

نمایش 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)
  }
}
فیلدها
name

string

فقط خروجی. نام منبع تبلیغ. این فیلد فرمتی به شکل "networks/" خواهد داشت. /دارایی‌ها/ /adBreaks/ «. (یا: "باورم نمی‌شود که آدم‌ها اشتباه می‌کنند.")

network_code کد شبکه‌ای در Google Ad Manager است که این محتوا به آن تعلق دارد.

asset_key کلید رویداد پخش زنده در مدیریت تبلیغات گوگل است که تحت آن تبلیغ فوری ایجاد شده است.

adBreakId کلید Ad Break است. فقط خروجی.

createTime

string ( Timestamp format)

فقط خروجی. زمان ایجاد تبلیغ ناگهانی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

expectedDuration

string ( Duration format)

الزامی. مدت زمان استراحت مورد انتظار.

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

customParams
(deprecated)

string

اختیاری. جفت‌های کلید-مقدار که در درخواست‌های تبلیغ برای این وقفه برای هدف‌گیری معیارهای سفارشی در مدیریت تبلیغات گنجانده می‌شوند. مثال: 'key1=value&key2=value2,value22' منسوخ شده: لطفاً cust_params را در breakParams.ad_tag_params با استفاده از کلید "cust_params" تنظیم کنید.

scte35CueOut

string

اختیاری. داده‌های کدگذاری شده پایه ۶۴ از خروجی scte35. می‌تواند شامل دستور splice_insert() یا time_signal() باشد. مثال‌ها: - با time_signal(): "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==" - با splice_insert(): "/DAvAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="

podTemplateName
(deprecated)

string

اختیاری. نام قالب پاد مدیریت تبلیغات گوگل. منسوخ شده: لطفاً با استفاده از کلید "ptpln" مقدار cust_params را در breakParams.ad_tag_params تنظیم کنید.

breakState

enum ( BreakState )

فقط خروجی. وضعیت فعلی تبلیغ ناگهانی.

expectedStartTime

string ( Timestamp format)

اختیاری. زمان شروع مورد انتظار پخش تبلیغات.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

expireDuration

string ( Duration format)

اختیاری. زمان انقضای تبلیغ در expectsStartTime + expireDuration تنظیم می‌شود. اگر expectsStartTime تنظیم نشده باشد، تبلیغ پس از تصمیم‌گیری برای شروع، expireDuration خواهد شد. پیش‌فرض: ۳۰ دقیقه حداقل: ۵ دقیقه حداکثر: ۶ ساعت

مدت زمانی بر حسب ثانیه با حداکثر نه رقم کسری که به ' s ' ختم می‌شود. مثال: "3.5s" .

breakSequence

string ( int64 format)

فقط خروجی. شناسه توالی میان‌برنامه‌ایِ Ad Break. چندین Ad Break می‌توانند breakSequence یکسانی داشته باشند، اگر به صراحت از طریق breakParams.ad_tag_params با کلید mridx مشخص شده باشند. این به طور مؤثر دو Ad Break GAM را به هم مرتبط می‌کند.

breakParams

object ( BreakParams )

اختیاری. پارامترهای وقفه‌ای که باید در درخواست‌های تبلیغ برای این وقفه لحاظ شوند.

matchParams

object ( MatchParams )

اختیاری. برای Stitched DAI استفاده می‌شود تا مشخص کند که چگونه یک Ad Break ایجاد شده از طریق API با یک Ad Break درون مانیفست مطابقت دارد. هنگامی که یک Break جدید شناسایی می‌شود، یک تابع match برای تمام Ad Breakهای یک رویداد که breakState آنها SCHEDULED یا DECISIONED است، اجرا می‌شود تا بررسی شود که آیا تمام پارامترهای تنظیم شده در matchParams یک Ad Break با Break شناسایی شده مطابقت دارند یا خیر. اگر هر یک از این شرایط برآورده شود، تطابق رخ می‌دهد: ۱. Ad Break دارای یک فیلد matchParams است و تمام پارامترهای تنظیم شده در آن با Break جدید مطابقت دارند. ۲. Ad Break دارای DECISIONED است و فیلد matchParams ندارد.

برای جلوگیری از رفتار تصادفی "match-all" (که با یک matchParams خالی اما موجود رخ می‌دهد)، matchParams در صورت تنظیم نمی‌تواند خالی باشد. اگر فیلد در یک درخواست وجود داشته باشد، حداقل یکی از فیلدهای خودش باید تنظیم شود.

وقفه‌های تبلیغاتی (Ad Breaks) به این ترتیب بررسی می‌شوند: ۱. با matchParams، مرتب شده بر اساس expectedStartTime صعودی، createTime صعودی، که در آن وقفه‌های تبلیغاتی بدون expectedStartTime هنگام مرتب‌سازی در اولویت قرار می‌گیرند. ۲. بدون matchParams، مرتب شده بر اساس expectedStartTime صعودی، createTime صعودی، که در آن وقفه‌های تبلیغاتی بدون expectedStartTime هنگام مرتب‌سازی در اولویت قرار می‌گیرند.

اگر همه EABN های در حال انتظار مطابقت نداشته باشند، DAI با استفاده از شاخص میان‌دوره‌ای بعدی موجود، به رفتار تصمیم‌گیری JIT باز می‌گردد.

servedBreak

object ( ServedBreak )

فقط خروجی. این اطلاعات واقعی وقفه تبلیغاتی نمایش داده شده را نشان می‌دهد. فقط برای وقفه‌های تبلیغاتی با وضعیت COMPLETE وقفه تنظیم می‌شود.

روش‌ها

create

 API برای ایجاد یک تبلیغ کوتاه (Ad Break) در پخش زنده.

delete

 API برای حذف آگهی تبلیغاتی در پخش زنده.

get

 API برای دریافت تبلیغات لحظه‌ای در پخش زنده.

list

 API برای فهرست کردن وقفه‌های تبلیغاتی در پخش زنده.

patch

 API برای به‌روزرسانی یک تبلیغ ناگهانی در پخش زنده.