DAI विज्ञापन के लिए ब्रेक API का इस्तेमाल करना

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

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

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

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 विज्ञापन के लिए ब्रेक 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 ऐसी इकाइयां दिखाता है जिन्हें एपीआई के ज़रिए बनाया गया है. इसमें मेनिफ़ेस्ट, पॉड सेगमेंट के अनुरोध या पॉड मेनिफ़ेस्ट के अनुरोध से बनाए गए विज्ञापन के लिए ब्रेक शामिल नहीं होते.

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

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==",
      "breakParams": {
        "adTagParams": [
          {
            "key": "ptpln",
            "value": "podtemplate"
          },
          {
            "key": "cust_params",
            "value": "param1=value1&param2=value2"
          }
        ]
      },
      "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==",
      "breakParams": {
        "adTagParams": [
          {
            "key": "ptpln",
            "value": "podtemplate"
          },
          {
            "key": "cust_params",
            "value": "param1=value1&param2=value2"
          }
        ]
      },
      "breakState": "BREAK_STATE_COMPLETE"
    },
    ...
  ],
  "nextPageToken": "ChAIARIMCNDn97IGEJbhhYUC"
}

AdBreak इकाई बनाना

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

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

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

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==",
    "breakParams": {
      "adTagParams": [
        {
          "key": "ptpln",
          "value": "podtemplate"
        },
        {
          "key": "cust_params",
          "value": "param1=value1&param2=value2"
        }
      ]
    }
  }'

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

{
  "name": "networks/.../assets/.../adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:00:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "breakParams": {
    "adTagParams": [
      {
        "key": "ptpln",
        "value": "podtemplate"
      },
      {
        "key": "cust_params",
        "value": "param1=value1&param2=value2"
      }
    ]
  },
  "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==",
  "breakParams": {
    "adTagParams": [
      {
        "key": "ptpln",
        "value": "podtemplate"
      },
      {
        "key": "cust_params",
        "value": "param1=value1&param2=value2"
      }
    ]
  },
  "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==",
  "breakParams": {
    "adTagParams": [
      {
        "key": "ptpln",
        "value": "podtemplate"
      },
      {
        "key": "cust_params",
        "value": "param1=value1&param2=value2"
      }
    ]
  },
  "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 की इन सुविधाओं के बारे में जानें: