DAI অ্যাড ব্রেক API ব্যবহার করুন

DAI অ্যাড ব্রেক API আপনাকে আপনার লাইভস্ট্রিমে বিজ্ঞাপন বিরতির সময় এবং বিজ্ঞাপন লক্ষ্যবস্তু ডেটা তৈরি, পরিচালনা করতে দেয়।

এই নির্দেশিকাটিতে Google Dynamic Ads Insertion (DAI) লাইভস্ট্রিম ইভেন্টের জন্য একটি বিজ্ঞাপন বিরতি তৈরি, আপডেট এবং মুছে ফেলার জন্য DAI Ad Break API ব্যবহার করা সম্পর্কে আলোচনা করা হয়েছে।

পূর্বশর্ত

DAI অ্যাড ব্রেক API ব্যবহার করতে, আপনার নিম্নলিখিতগুলি প্রয়োজন:

API অ্যাক্সেস সেট আপ করুন

API সক্রিয় করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

  1. একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন। আরও তথ্যের জন্য, একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন দেখুন।
  2. আপনার Google বিজ্ঞাপন ম্যানেজার নেটওয়ার্কে পরিষেবা অ্যাকাউন্ট যোগ করুন। আরও তথ্যের জন্য, API অ্যাক্সেসের জন্য একটি পরিষেবা অ্যাকাউন্ট ব্যবহারকারী যোগ করুন দেখুন।
  3. আপনার Google অ্যাকাউন্ট ম্যানেজারকে পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানা এবং আপনার Google বিজ্ঞাপন ম্যানেজার নেটওয়ার্ক কোড দিন।
  4. আপনার Google Cloud প্রোজেক্টে Google Ad Manager Video API সক্ষম করুন। আরও তথ্যের জন্য, আপনার অ্যাপের জন্য "API & Services" সক্ষম করুন দেখুন।

OAuth2 দিয়ে প্রমাণীকরণ করুন

আপনার API অনুরোধগুলি অনুমোদন করতে, নিম্নলিখিত পদক্ষেপগুলি অনুসরণ করুন:

  1. https://www.googleapis.com/auth/video-ads স্কোপের সাহায্যে অ্যাক্সেস টোকেন তৈরি করুন ।
  2. প্রতিটি অনুরোধে, API-তে অ্যাক্সেস টোকেনটি Authorization HTTP হেডার Bearer মান হিসেবে অন্তর্ভুক্ত করুন। আরও তথ্যের জন্য, Call Google API দেখুন।

নিম্নলিখিত উদাহরণটি DAI অ্যাড ব্রেক API এর স্কোপ সহ একটি OAuth টোকেন তৈরি করে:

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

সফল হলে, আপনি নিম্নলিখিত অ্যাক্সেস টোকেনটি দেখতে পাবেন:

ya29.c.c0ASRK0GYUYU0...

প্রথম অনুরোধটি করুন

লাইভস্ট্রিম ইভেন্টের জন্য বিজ্ঞাপন বিরতি পুনরুদ্ধার করতে, ইভেন্টের সিস্টেম জেনারেটেড অ্যাসেট কী , অথবা আপনার কাস্টম অ্যাসেট কী দ্বারা সমস্ত AdBreak সত্তা তালিকাভুক্ত করতে GET পদ্ধতি ব্যবহার করুন।

DAI অ্যাড ব্রেক API শুধুমাত্র 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": []
}

API এর মাধ্যমে অতিরিক্ত 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 এন্টিটি তৈরি করতে, উন্নত কনফিগারেশনের জন্য আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

নিম্নলিখিত উদাহরণের অনুরোধটি একটি বিজ্ঞাপন বিরতি তৈরি করে যা ৩ জুন, ২০২৫ তারিখে, ১৫:০০:০০ UTC-তে শুরু হওয়ার সম্ভাবনা রয়েছে:

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 সত্তা মুছুন

বিজ্ঞাপন বিরতি পরিবেশন শুরু হওয়ার আগে API এর মাধ্যমে তৈরি করা বিজ্ঞাপন বিরতির বিজ্ঞাপনের সিদ্ধান্ত বাতিল করতে 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 বিজ্ঞাপন বিরতি API-এর এই বৈশিষ্ট্যগুলি অন্বেষণ করুন: