DAI Ad Break API का इस्तेमाल करना

DAI Ad Break API की मदद से, लाइव स्ट्रीम में विज्ञापन ब्रेक बनाए जा सकते हैं. साथ ही, विज्ञापन ब्रेक के समय और विज्ञापन टारगेटिंग डेटा को मैनेज किया जा सकता है.

इस गाइड में, Google के डाइनैमिक ऐड इंसर्शन (डीएआई) की मदद से लाइव स्ट्रीम किए जाने वाले इवेंट के लिए, विज्ञापन ब्रेक बनाने, अपडेट करने, और मिटाने के लिए, डीएआई ऐड ब्रेक एपीआई का इस्तेमाल करने के बारे में बताया गया है.

ज़रूरी शर्तें

DAI Ad Break API का इस्तेमाल करने के लिए, आपके पास ये चीज़ें होनी चाहिए:

एपीआई ऐक्सेस सेट अप करना

एपीआई चालू करने के लिए, यह तरीका अपनाएं:

  1. कोई सेवा खाता बनाएं. ज़्यादा जानकारी के लिए, सेवा खाता बनाना लेख पढ़ें.
  2. सेवा खाते को अपने Google Ad Manager नेटवर्क में जोड़ें. ज़्यादा जानकारी के लिए, एपीआई ऐक्सेस करने के लिए सेवा खाते का उपयोगकर्ता जोड़ना लेख पढ़ें.
  3. अपने Google खाता मैनेजर को सेवा खाते का ईमेल पता और Google Ad Manager नेटवर्क कोड दें.
  4. अपने Google Cloud प्रोजेक्ट में Google Ad Manager Video API चालू करें. ज़्यादा जानकारी के लिए, अपने ऐप्लिकेशन के लिए "एपीआई और सेवाएं" चालू करना लेख पढ़ें.

OAuth2 की मदद से पुष्टि करना

अपने एपीआई अनुरोधों को अनुमति देने के लिए, यह तरीका अपनाएं:

  1. https://www.googleapis.com/auth/video-ads स्कोप के साथ ऐक्सेस टोकन जनरेट करें.
  2. हर अनुरोध में, एपीआई के ऐक्सेस टोकन को Authorization एचटीटीपी हेडर Bearer वैल्यू के तौर पर शामिल करें. ज़्यादा जानकारी के लिए, Google API को कॉल करना लेख पढ़ें.

नीचे दिए गए उदाहरण में, DAI Ad Break API के स्कोप के साथ एक OAuth टोकन जनरेट किया गया है:

gcloud auth print-access-token --scopes='https://www.googleapis.com/auth/video-ads'

अगर यह प्रोसेस पूरी हो जाती है, तो आपको यह ऐक्सेस टोकन दिखेगा:

ya29.c.c0ASRK0GYUYU0...

पहला अनुरोध करना

लाइव स्ट्रीम इवेंट के लिए विज्ञापन ब्रेक वापस पाने के लिए, GET तरीके का इस्तेमाल करके इवेंट के सिस्टम से जनरेट किए गए ऐसेट कुंजी या आपके कस्टम ऐसेट कुंजी के हिसाब से सभी AdBreak इकाइयां लिस्ट करें.

DAI Ad Break API सिर्फ़ उन AdBreak इकाइयों को दिखाता है जिन्हें एपीआई के ज़रिए बनाया गया है. इसमें मेनिफ़ेस्ट, पॉड सेगमेंट के अनुरोध या पॉड मेनिफ़ेस्ट के अनुरोध से बनाए गए विज्ञापन ब्रेक शामिल नहीं होते.

यहां दिए गए अनुरोध के उदाहरण में, AdBreak वैल्यू के हिसाब से AdBreak इकाइयों की सूची दी गई है:assetKey

curl -X GET "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN"

अगर अनुरोध सही से काम करता है, तो आपको यह JSON रिस्पॉन्स दिखेगा:

{
 "adBreaks": []
}

एपीआई के ज़रिए अतिरिक्त AdBreak इकाइयां बनाने और सूची का अनुरोध करने पर, आपको यह JSON रिस्पॉन्स दिखेगा:

{
 "adBreaks": [
    {
      "name": "networks/.../assets/.../adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
      "expectedDuration": "30s",
      "expectedStartTime": "2025-06-03T15:00:00Z",
      "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
      "customParams": "param1=value1&param2=value2",
      "podTemplateName": "podtemplate"
      "breakState": "BREAK_STATE_SCHEDULED",
    },
    {
      "name": "networks/.../assets/.../adBreaks/cc68b0df-0257-46e7-8193-254060b6256c",
      "breakSequence": "1",
      "expectedDuration": "30s",
      "expectedStartTime": "2025-06-03T14:30:00Z",
      "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
      "customParams": "param1=value1&param2=value2",
      "podTemplateName": "podtemplate"
      "breakState": "BREAK_STATE_COMPLETE",
    },
    …
  ],
  "nextPageToken": "ChAIARIMCNDn97IGEJbhhYUC"
}

AdBreak इकाई बनाना

लाइव स्ट्रीम इवेंट के लिए, आने वाले विज्ञापन ब्रेक की सूचना Google DAI को देने के लिए, POST तरीके का इस्तेमाल करें.

  • नई AdBreak इकाई बनाने के लिए, आपको पिछली इकाई के BREAK_STATE_COMPLETE स्थिति में आने का इंतज़ार करना होगा.
  • इसके अलावा, नई AdBreak इकाई बनाने के लिए, आपको मंज़ूरी के लिए भेजी गई इकाई को मिटाना होगा.
  • किसी एक लाइव स्ट्रीम इवेंट के लिए एक से ज़्यादा AdBreak इकाइयां बनाने के लिए, बेहतर कॉन्फ़िगरेशन के लिए अपने खाता मैनेजर से संपर्क करें.

यहां दिए गए अनुरोध के उदाहरण में, एक ऐसा विज्ञापन ब्रेक बनाया गया है जो 3 जून, 2025 को शाम 3 बजे यूटीसी पर शुरू होगा:

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/{NETWORK_CODE}/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate"
  }'

अगर अनुरोध सही से काम करता है, तो आपको यह JSON रिस्पॉन्स दिखेगा:

{
  "name": "networks/.../assets/.../adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",  "expectedStartTime": "2025-06-03T15:00:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
}

नतीजे में, विज्ञापन ब्रेक का आईडी होता है. इसकी मदद से, विज्ञापन ब्रेक को वापस लाया जा सकता है, उसमें बदलाव किया जा सकता है या उसे मिटाया जा सकता है. जवाब के इस उदाहरण में, बनाए गए विज्ञापन ब्रेक का आईडी bcc402a6-9880-4b8b-8e4a-a8cd3688f854 है.

AdBreak इकाई को वापस पाना

किसी AdBreak इकाई की जानकारी वापस पाने के लिए, GET तरीके का इस्तेमाल करें. इसमें विज्ञापन के लिए ब्रेक की स्थिति और समय का मेटाडेटा शामिल है.

curl -X GET \
'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN'

अगर अनुरोध सही से काम करता है, तो आपको यह JSON रिस्पॉन्स दिखेगा:

{
  "name": "networks/.../assets/.../adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:10:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
}

AdBreak इकाई को अपडेट करना

विज्ञापन दिखाने का फ़ैसला लेने से पहले, विज्ञापन के लिए ब्रेक में बदलाव करने के लिए, PATCH तरीके का इस्तेमाल करें:

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{"expectedStartTime": "2025-06-03T15:10:00Z"}'

अगर अनुरोध सही से काम करता है, तो आपको यह JSON रिस्पॉन्स दिखेगा:

{
  "name": "networks/.../assets/.../adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:10:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
}

AdBreak इकाई मिटाना

विज्ञापन के लिए ब्रेक शुरू होने से पहले, एपीआई के ज़रिए बनाए गए विज्ञापन के लिए ब्रेक के विज्ञापन से जुड़े फ़ैसले को रद्द करने के लिए, DELETE तरीके का इस्तेमाल करें.

अनुरोध के इस उदाहरण में, विज्ञापन के लिए ब्रेक को मिटाया गया है:

curl -X DELETE 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Authorization: Bearer OAUTH_TOKEN'

अगर अनुरोध पूरा हो जाता है, तो आपको HTTP/1.1 200 OK जवाब दिखेगा.

विज्ञापन ब्रेक की बेहतर सुविधाओं के बारे में जानें

विज्ञापन ब्रेक बनाने और उन्हें मैनेज करने के बाद, DAI AdBreak API की इन सुविधाओं के बारे में जानें: