REST Resource: networks.sources.content.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//assets//adBreaks/".

‫network_code هو معرِّف الشبكة في "إدارة إعلانات Google" الذي ينتمي إليه هذا المحتوى.

‫asset_key هو مفتاح "حدث البث المباشر" في "إدارة إعلانات Google" الذي تم إنشاء "فواصل الإعلانات" ضمنه.

adBreakId هو مفتاح "الفاصل الإعلاني". النتائج فقط.
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء الفاصل الإعلاني

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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

اختياريّ. أزواج المفتاح/القيمة التي سيتم تضمينها في طلبات الإعلان لهذا الفاصل لاستهداف المعايير المخصّصة في "مدير إعلانات Google" مثال: ‎'key1=value&key2=value2,value22' تم إيقافها نهائيًا: يُرجى ضبط cust_params في breakParams.ad_tag_params باستخدام المفتاح "cust_params".
scte35CueOut

string

اختياريّ. بيانات مشفّرة باستخدام Base64 من إشارة scte35 cue out قد يتضمّن الأمر splice_insert() أو time_signal(). أمثلة: - باستخدام time_signal(): ‎“/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==”‎ - باستخدام splice_insert(): ‎"/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="‎
podTemplateName
(deprecated)

string

اختياريّ. اسم نموذج مجموعة الإعلانات المتسلسلة في "إدارة إعلانات Google". متوقّف نهائيًا: يُرجى ضبط cust_params في breakParams.ad_tag_params باستخدام المفتاح "ptpln".
breakState

enum (BreakState)

النتائج فقط. الحالة الحالية لفاصل الإعلانات
expectedStartTime

string (Timestamp format)

اختياريّ. تمثّل هذه السمة وقت البدء المتوقّع للفاصل الإعلاني.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
expireDuration

string (Duration format)

اختياريّ. تنتهي صلاحية "الفاصل الإعلاني" عند expectedStartTime + expireDuration. إذا لم يتم ضبط expectedStartTime، ستنتهي صلاحية "فواصل الإعلانات" بعد انتهاء مدة expireDuration من بدء عملية اتّخاذ القرار. القيمة التلقائية: 30 دقيقة الحد الأدنى: 5 دقائق الحد الأقصى: 6 ساعات

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
breakSequence

string (int64 format)

النتائج فقط. رقم تعريف تسلسل الإعلانات أثناء التشغيل في منتصف الفيديو لفاصل الإعلانات قد تتضمّن فواصل إعلانية متعدّدة breakSequence نفسه إذا تمّ تحديده بشكلٍ صريح من خلال breakParams.ad_tag_params باستخدام المفتاح mridx. يؤدي ذلك إلى ربط فاصلَين إعلانيَين في "مدير إعلانات Google" بشكل فعّال.
breakParams

object (BreakParams)

اختياريّ. مَعلمات الفاصل التي سيتم تضمينها في طلبات الإعلانات لهذا الفاصل
matchParams

object (MatchParams)

اختياريّ. يُستخدم في "إعلانات DAI المدمجة" لتحديد كيفية مطابقة "فواصل إعلانية" تم إنشاؤها من خلال واجهة برمجة التطبيقات مع "فواصل إعلانية" في ملف البيان. عند رصد فاصل إعلاني جديد، سيتم تشغيل دالة مطابقة مع جميع الفواصل الإعلانية لحدث يتضمّن breakState بقيمة SCHEDULED أو DECISIONED للتحقّق مما إذا كانت جميع المَعلمات المضبوطة في matchParams الخاصة بـ "الفاصل الإعلاني" تتطابق مع الفاصل الإعلاني الذي تم رصده. تحدث المطابقة إذا تم استيفاء أحد الشرطين التاليين: 1. يتضمّن فاصل الإعلانات الحقل matchParams، وتتطابق جميع المَعلمات التي تم ضبطها فيه مع الفاصل الإعلاني الجديد. 2. فاصل الإعلان هو DECISIONED ولا يحتوي على حقل matchParams.

لمنع حدوث سلوك "المطابقة مع الكل" عن طريق الخطأ (الذي سيحدث مع matchParams فارغ ولكن موجود)، لا يمكن أن يكون matchParams فارغًا إذا تم ضبطه. إذا كان الحقل متوفّرًا في الطلب، يجب ضبط حقل واحد على الأقل من حقوله.

يتم التحقّق من فواصل الإعلانات بهذا الترتيب: 1. مع matchParams، ويتم ترتيبها حسب expectedStartTime تصاعديًا وcreateTime تصاعديًا، مع إعطاء الأولوية لفواصل الإعلانات التي لا تتضمّن expectedStartTime عند ترتيبها 2. بدون matchParams، ويتم ترتيبها حسب expectedStartTime تصاعديًا وcreateTime تصاعديًا، مع إعطاء الأولوية لفواصل الإعلانات التي لا تتضمّن expectedStartTime عند ترتيبها

إذا لم تتطابق كل أرقام تعريف الشبكة الخارجية المعلقة، ستعود ميزة "الإعلانات الديناميكية أثناء البث" إلى سلوك اتّخاذ القرار أثناء التنفيذ باستخدام فهرس الإعلانات أثناء التشغيل التالي المتاح.
servedBreak

object (ServedBreak)

النتائج فقط. تعكس هذه السمة المعلومات الفعلية لفاصل الإعلانات المعروض. يتم ضبطها فقط على فواصل إعلانية تتضمّن COMPLETE breakState.

الطُرق

create

 واجهة برمجة التطبيقات لإنشاء "فواصل إعلانية" ضمن البث المباشر

list

 واجهة برمجة التطبيقات لعرض "فواصل إعلانية" ضمن البث المباشر