আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

DAI বিজ্ঞাপন বিরতি API ব্যবহার করা

Google Dynamic Ad Insertion (DAI) Ad Break API আপনাকে লাইভস্ট্রিমে বিজ্ঞাপন বিরতির সময় ও বিজ্ঞাপন টার্গেটিং ডেটা তৈরি ও ম্যানেজ করতে দেয়।

এই নির্দেশিকায় Google DAI লাইভ স্ট্রিম ইভেন্টের জন্য বিজ্ঞাপন বিরতি তৈরি, আপডেট ও মুছে দেওয়ার জন্য DAI বিজ্ঞাপন বিরতি API ব্যবহার করার বিষয়ে বলা হয়েছে।

পূর্বশর্ত

DAI বিজ্ঞাপন বিরতি API ব্যবহার করতে, আপনার এগুলি প্রয়োজন:

admanagervideo.googleapis.com পরিষেবা চালু করা আছে এমন Google Cloud প্রোজেক্ট। আরও তথ্যের জন্য, Cloud প্রোজেক্ট তৈরি করুন দেখুন।
Google DAI লাইভ স্ট্রিম ইভেন্ট সহ Google Ad Manager নেটওয়ার্ক। আরও তথ্যের জন্য, DAI-এর জন্য লাইভ স্ট্রিম সেট-আপ করুন লিঙ্কে দেখুন।

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

API চালু করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

পরিষেবা অ্যাকাউন্ট তৈরি করুন। আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট তৈরি করুন দেখুন।
আপনার Google Ad Manager নেটওয়ার্কে পরিষেবা অ্যাকাউন্ট যোগ করুন। আরও তথ্যের জন্য, API অ্যাক্সেসের জন্য পরিষেবা অ্যাকাউন্ট ব্যবহারকারী যোগ করুন দেখুন।
আপনার Google অ্যাকাউন্ট ম্যানেজারের কাছে পরিষেবা অ্যাকাউন্টের ইমেল আইডি এবং আপনার Google Ad Manager নেটওয়ার্ক কোড দিন।
আপনার Google Cloud প্রোজেক্টে Google Ad Manager Video API চালু করুন। আরও তথ্যের জন্য, আপনার অ্যাপের জন্য "API ও পরিষেবা" চালু করুন।

OAuth2-এর মাধ্যমে যাচাইকরণ

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

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

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

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

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

ya29.c.c0ASRK0GYUYU0...

প্রথম অনুরোধ করা

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

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

নিচে দেওয়া অনুরোধের উদাহরণে ৩ জুন, ২০২৫ তারিখে ১৫:০০:০০ 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 Ad Break API-এর এইসব ফিচার এক্সপ্লোর করুন:

বিজ্ঞাপন বিরতির জন্য বিজ্ঞাপন ট্যাগ প্যারামিটার ওভাররাইড করতে অথবা থার্ড-পার্টি বিজ্ঞাপন সিস্টেমের সাথে ইন্টিগ্রেট করতে, বিজ্ঞাপন বিরতির প্যারামিটার ব্যবহার করুন বিকল্প দেখুন।
বিজ্ঞাপন সংক্রান্ত প্লেব্যাক সমস্যা আটকাতে, বিজ্ঞাপন বিরতি ও সেগমেন্টের সময়সীমা ম্যানেজ করুন।