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

DAI Ad Break API আপনাকে আপনার লাইভস্ট্রিমে বিজ্ঞাপন বিরতির সময় এবং বিজ্ঞাপন টার্গেটিং ডেটা তৈরি ও পরিচালনা করতে দেয়।

এই নির্দেশিকায় একটি গুগল ডাইনামিক অ্যাডস ইনসারশন (DAI) লাইভস্ট্রিম ইভেন্টের জন্য অ্যাড ব্রেক তৈরি, আপডেট এবং ডিলিট করতে DAI অ্যাড ব্রেক API ব্যবহারের পদ্ধতি বর্ণনা করা হয়েছে।

পূর্বশর্ত

DAI Ad Break API ব্যবহার করার জন্য আপনার নিম্নলিখিত বিষয়গুলো প্রয়োজন:

এপিআই অ্যাক্সেস সেট আপ করুন

এপিআই সক্রিয় করতে, নিম্নলিখিত ধাপগুলি সম্পন্ন করুন:

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

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

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

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

নিম্নলিখিত উদাহরণটি DAI Ad Break API-এর স্কোপ সহ একটি OAuth টোকেন তৈরি করে:

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

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

ya29.c.c0ASRK0GYUYU0...

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

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

DAI Ad Break API শুধুমাত্র সেইসব AdBreak এনটিটি ফেরত দেয় যেগুলো এই API-এর মাধ্যমে তৈরি করা হয়েছে; ম্যানিফেস্ট, পড সেগমেন্ট রিকোয়েস্ট বা পড ম্যানিফেস্ট রিকোয়েস্ট থেকে তৈরি করা অ্যাড ব্রেকগুলো এর অন্তর্ভুক্ত নয়।

নিম্নলিখিত উদাহরণ অনুরোধটি একটি 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 এনটিটিটিটি মুছে ফেলতে পারেন।
  • একটি লাইভস্ট্রিম ইভেন্টের জন্য একাধিক 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 সত্তা মুছে ফেলুন

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