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//assets//adBreaks/" होगा.

network_code, Google Ad Manager में मौजूद वह नेटवर्क कोड है जिससे यह कॉन्टेंट जुड़ा है.

asset_key, Google Ad Manager में मौजूद लाइव स्ट्रीम इवेंट की कुंजी है. इसी इवेंट के तहत विज्ञापन ब्रेक बनाया गया था.

adBreakId, विज्ञापन के लिए ब्रेक की कुंजी है. OUTPUT ONLY.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. विज्ञापन ब्रेक बनाए जाने का समय.

यह आरएफ़सी 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

ज़रूरी नहीं. Ad Manager में कस्टम शर्तों के हिसाब से टारगेटिंग के लिए, इस ब्रेक के विज्ञापन अनुरोधों में शामिल किए जाने वाले की-वैल्यू पेयर. उदाहरण: 'key1=value&key2=value2,value22' अब इस्तेमाल नहीं किया जा सकता: कृपया "cust_params" कुंजी का इस्तेमाल करके, breakParams.ad_tag_params में cust_params सेट करें.
scte35CueOut

string

ज़रूरी नहीं. scte35 cue out से मिला, Base 64 में एन्कोड किया गया डेटा. इसमें splice_insert() या time_signal() कमांड शामिल हो सकती है. उदाहरण: - with time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - with splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
podTemplateName
(deprecated)

string

ज़रूरी नहीं. Google Ad Manager पॉड टेंप्लेट का नाम. बंद कर दिया गया: कृपया "ptpln" कुंजी का इस्तेमाल करके, breakParams.ad_tag_params में cust_params सेट करें.
breakState

enum (BreakState)

सिर्फ़ आउटपुट के लिए. विज्ञापन ब्रेक की मौजूदा स्थिति.
expectedStartTime

string (Timestamp format)

ज़रूरी नहीं. विज्ञापन ब्रेक के शुरू होने का अनुमानित समय.

यह आरएफ़सी 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)

सिर्फ़ आउटपुट के लिए. विज्ञापन ब्रेक का मिडरॉल सीक्वेंस आईडी. अगर breakParams.ad_tag_params में mridx कुंजी का इस्तेमाल करके साफ़ तौर पर बताया गया है, तो विज्ञापन के लिए एक से ज़्यादा ब्रेक का breakSequence एक जैसा हो सकता है. इससे GAM के दो विज्ञापन ब्रेक लिंक हो जाते हैं.
breakParams

object (BreakParams)

ज़रूरी नहीं. इस ब्रेक के लिए विज्ञापन अनुरोधों में शामिल किए जाने वाले ब्रेक पैरामीटर.
matchParams

object (MatchParams)

ज़रूरी नहीं. इस कुकी का इस्तेमाल स्टिच्ड डीएआई के लिए किया जाता है. इससे यह तय किया जाता है कि एपीआई के ज़रिए बनाया गया विज्ञापन ब्रेक, मेनिफ़ेस्ट में मौजूद विज्ञापन ब्रेक से कैसे मैच किया जाता है. जब किसी नए ब्रेक का पता चलता है, तो मैच फ़ंक्शन को किसी इवेंट के उन सभी विज्ञापन ब्रेक के ख़िलाफ़ चलाया जाएगा जिनका breakState SCHEDULED या DECISIONED है. इससे यह पता चलेगा कि विज्ञापन ब्रेक के matchParams में सेट किए गए सभी पैरामीटर, पता लगाए गए ब्रेक से मेल खाते हैं या नहीं. इनमें से कोई भी शर्त पूरी होने पर, मैच मिल जाता है: 1. विज्ञापन ब्रेक में matchParams फ़ील्ड होता है. इसमें सेट किए गए सभी पैरामीटर, नए ब्रेक से मेल खाते हैं. 2. विज्ञापन ब्रेक DECISIONED है और इसमें matchParams फ़ील्ड नहीं है.

अगर matchParams सेट किया गया है, तो उसे खाली नहीं छोड़ा जा सकता. ऐसा इसलिए, ताकि गलती से "सभी से मैच करें" व्यवहार न हो (यह तब होता है, जब matchParams मौजूद हो, लेकिन खाली हो). अगर फ़ील्ड किसी अनुरोध में मौजूद है, तो उसके कम से कम एक फ़ील्ड को सेट किया जाना चाहिए.

विज्ञापन ब्रेक की जांच इस क्रम में की जाती है: 1. matchParams के साथ, expectedStartTime के हिसाब से बढ़ते क्रम में, createTime के हिसाब से बढ़ते क्रम में. इसमें, expectedStartTime के बिना विज्ञापन ब्रेक को क्रम से लगाने पर प्राथमिकता दी जाती है 2. matchParams के बिना, expectedStartTime के हिसाब से बढ़ते क्रम में, createTime के हिसाब से बढ़ते क्रम में. इसमें, expectedStartTime के बिना विज्ञापन ब्रेक को क्रम से लगाने पर प्राथमिकता दी जाती है

अगर सभी लंबित EABN मैच नहीं होते हैं, तो DAI, JIT फ़ैसले लेने के तरीके पर वापस आ जाएगा. इसके लिए, वह अगले उपलब्ध मिडरोल इंडेक्स का इस्तेमाल करेगा
servedBreak

object (ServedBreak)

सिर्फ़ आउटपुट के लिए. इससे दिखाए गए विज्ञापन ब्रेक की असल जानकारी मिलती है. इसे सिर्फ़ COMPLETE breakState वाले विज्ञापन ब्रेक के लिए सेट करें.

तरीके

create

 लाइव स्ट्रीम में विज्ञापन ब्रेक बनाने के लिए एपीआई.

delete

 लाइव स्ट्रीम में विज्ञापन के लिए ब्रेक को मिटाने के लिए एपीआई.

get

 लाइव स्ट्रीम में विज्ञापन ब्रेक पाने के लिए एपीआई.

list

 लाइव स्ट्रीम में विज्ञापन ब्रेक की सूची बनाने के लिए एपीआई.

patch

 लाइव स्ट्रीम में विज्ञापन ब्रेक अपडेट करने के लिए एपीआई.