DAI প্রারম্ভিক বিজ্ঞাপন বিরতি বিজ্ঞপ্তি API

দ্রষ্টব্য: এই API এখনও বিটা মধ্যে আছে. আপনি যদি EABN প্রোগ্রামে অ্যাক্সেসের অনুরোধ করতে চান তাহলে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে কথা বলুন।

Google DAI প্ল্যাটফর্ম ব্যবহার করার সময়, আপনি একটি স্ট্রিমে পরবর্তী আসন্ন লাইভ/লিনিয়ার বিজ্ঞাপন বিরতির জন্য টার্গেটিং ডেটা প্রদান করতে চাইতে পারেন। আর্লি অ্যাড ব্রেক নোটিফিকেশন (EABN) API আপনাকে কী-মান জোড়া ব্যবহার করে ব্রেক-নির্দিষ্ট টার্গেটিং প্রয়োগ করতে দেয়, যা উচ্চ-ভলিউম স্ট্রিমগুলিতে বিজ্ঞাপনের সিদ্ধান্ত নেওয়ার জন্য মাপযোগ্যতা প্রদান করে।

সতর্কতা: EABN অনুরোধগুলি অপরিবর্তনীয়, তাই একবার বিরতি তৈরি হলে, এটি সংশোধন করা যাবে না। একই ইভেন্টের জন্য বিজ্ঞাপন বিরতি তৈরি করার পরবর্তী অনুরোধগুলি প্রত্যাখ্যান করা হয় যতক্ষণ না বিরতিটি ইভেন্টের ম্যানিফেস্টে উপস্থিত হয়৷

EABN API-তে করা কলগুলিতে লক্ষ্য করার জন্য সম্পদ কী এবং পরবর্তী বিরতির প্রত্যাশিত সময়কাল অন্তর্ভুক্ত থাকতে হবে। সময়কাল যতটা সম্ভব প্রকৃত বিজ্ঞাপন বিরতির দৈর্ঘ্যের কাছাকাছি হওয়া প্রয়োজন। প্রেরিত প্রত্যাশিত সময়কাল প্রদত্ত বিজ্ঞাপন বিরতির চেয়ে কম হলে, আন্ডারফিল অ্যাড ব্রেক ফিল টাইপ (খালি স্লেটে ডিফল্ট) বিরতির বাকি অংশের জন্য ব্যবহার করা হয়। প্রদত্ত বিজ্ঞাপন বিরতির চেয়ে প্রত্যাশিত সময়কাল প্রেরিত হলে, বিজ্ঞাপন সম্পূর্ণ হওয়ার আগেই আপনার বিজ্ঞাপন বিরতি শেষ হতে পারে।

এই প্রয়োজনীয় ক্ষেত্রগুলি ছাড়াও, আপনি কাস্টম টার্গেটিং প্যারামিটার, প্রয়োগ করার জন্য একটি বিজ্ঞাপন পড টেমপ্লেটের নাম বা SCTE35 কিউ আউট ডেটা পাঠাতে পারেন, যদি উপলব্ধ থাকে।

পূর্বশর্ত

একটি পরিষেবা অ্যাকাউন্ট তৈরি করুন

EABN API অ্যাক্সেস করতে আপনার একটি Google পরিষেবা অ্যাকাউন্ট প্রয়োজন৷

• আপনার যদি একটি Google ক্লাউড অ্যাকাউন্ট থাকে, আপনি একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে IAM মডিউল ব্যবহার করতে পারেন। আরও তথ্যের জন্য, পরিষেবা অ্যাকাউন্ট তৈরি এবং পরিচালনা দেখুন।
• আপনার যদি একটি Google ক্লাউড অ্যাকাউন্ট না থাকে, আপনি এই পদক্ষেপগুলি অনুসরণ করে Google API কনসোল থেকে একটি পরিষেবা অ্যাকাউন্ট তৈরি করতে পারেন:
  1. একটি নতুন প্রকল্প তৈরি করুন বা একটি বিদ্যমান প্রকল্প নির্বাচন করুন।
  2. শংসাপত্র পৃষ্ঠায়, পরিষেবা অ্যাকাউন্ট পরিচালনা করুন ক্লিক করুন।
  3. পরিষেবা অ্যাকাউন্ট পৃষ্ঠায়, পরিষেবা অ্যাকাউন্ট তৈরি করুন ক্লিক করুন।
  4. পরিষেবা অ্যাকাউন্ট তৈরি করুন পৃষ্ঠায়, অ্যাকাউন্টের বিবরণ লিখুন। তারপর CREATE এ ক্লিক করুন।

একবার আপনি সফলভাবে একটি পরিষেবা অ্যাকাউন্ট তৈরি করলে, অ্যাকাউন্টের JSON কীটি অনুলিপি করুন, যা প্রমাণীকরণের জন্য ব্যবহার করা হবে।

EABN API সক্ষম করুন৷

একবার আপনার পরিষেবা অ্যাকাউন্ট তৈরি হয়ে গেলে, আপনার অ্যাকাউন্ট ম্যানেজারকে সেই অ্যাকাউন্টের জন্য EABN API সক্ষম করতে বলুন।

DAI API সক্ষম করুন

একবার আপনার পরিষেবা অ্যাকাউন্টের জন্য EABN API সক্ষম হয়ে গেলে, অ্যাকাউন্টে DAI API সক্ষম করুন:

1. Google API লাইব্রেরিতে , "DAI API" অনুসন্ধান করুন।

   দ্রষ্টব্য: সার্চের ফলাফলে APIটি উপস্থিত না হলে, আপনার অ্যাকাউন্ট DAI API-এর জন্য সক্ষম করা হয়েছে তা নিশ্চিত করতে আপনার অ্যাকাউন্ট পরিচালকের সাথে যোগাযোগ করুন।

2. DAI API নির্বাচন করুন এবং সক্রিয় করুন।

EABN API ব্যবহার করে

আপনি JSON/REST অনুরোধ ব্যবহার করে EABN API কল করতে পারেন।

প্রমাণীকরণ

EABN API-তে প্রমাণীকৃত কল করতে, আপনাকে আপনার পরিষেবা অ্যাকাউন্ট থেকে JSON কী ব্যবহার করে OAuth2 পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করতে হবে এবং https://www.googleapis.com/auth/video-ads স্কোপ। আরও তথ্যের জন্য, সার্ভার থেকে সার্ভার অ্যাপ্লিকেশনের জন্য OAuth 2.0 ব্যবহার করা দেখুন।

EABN API-তে প্রতিটি কলের জন্য একটি প্রমাণীকরণ শিরোনাম হিসাবে ফলাফল প্রমাণীকরণ টোকেন অবশ্যই অন্তর্ভুক্ত করতে হবে।

একটি প্রাথমিক বিজ্ঞাপন বিরতি বিজ্ঞপ্তি পাঠানো হচ্ছে

একটি প্রাথমিক বিজ্ঞাপন বিরতির বিজ্ঞপ্তি পাঠাতে, নিম্নলিখিত URL এবং অনুরোধের বডি ব্যবহার করে একটি POST অনুরোধ পাঠান:

POST dai.googleapis.com/v1/adBreaks

শরীরের অনুরোধ

অবজেক্ট
adBreak	প্রয়োজন	adBreak বৈশিষ্ট্যের জন্য মোড়ক বস্তু
assetKey	প্রয়োজন	LiveStreamEvent এর জন্য একটি অনন্য শনাক্তকারী যার জন্য বিরতি তৈরি করা হয়েছে৷
expectedDuration	প্রয়োজন	এই বিজ্ঞাপন বিরতির সময়কাল, Google-এর আদর্শ সময়কাল বিন্যাস ব্যবহার করে (xx.xxxs যেখানে xx.xxx সেকেন্ডের সংখ্যা)
scte35CueOut	ঐচ্ছিক	scte35 থেকে বেস-64-এনকোড করা ডেটা কিউ আউট। splice_insert() বা time_signal() কমান্ড অন্তর্ভুক্ত করতে পারে। উদাহরণ: time_signal() : /DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg== splice_insert() : /DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=
custParams	ঐচ্ছিক	AM360-এ কাস্টম মানদণ্ডের লক্ষ্যমাত্রার জন্য এই বিরতির জন্য বিজ্ঞাপনের অনুরোধে মূল-মূল্যের জোড়াগুলি অন্তর্ভুক্ত করা হবে, = দ্বারা পৃথক করা এবং & দ্বারা যোগ করা হয়েছে। উদাহরণ: key=value&key2=value2,value3 টার্গেটিং সম্পর্কে আরও তথ্যের জন্য, আপনার স্ট্রীমে টার্গেটিং প্যারামিটার সরবরাহ করুন দেখুন।
ptpln	ঐচ্ছিক	বিজ্ঞাপন পড টেমপ্লেট নাম

প্রতিক্রিয়া শিরোনাম

HTTP/1.1 200 OK

প্রতিক্রিয়া শরীর

প্রতিক্রিয়া বডিতে adBreak অবজেক্টে পাঠানো সমস্ত প্যারামিটার রয়েছে, সেইসাথে একটি অতিরিক্ত daiBreakId ফিল্ড রয়েছে, যেটিতে স্ট্রীমের মধ্যে তৈরি বিজ্ঞাপন বিরতির জন্য অভ্যন্তরীণ DAI শনাক্তকারী রয়েছে।

উদাহরণ

অনুরোধ

POST /v1/adBreaks HTTP/1.1
Content-Type: application/json

{
  "adBreak": {
    "assetKey": "asset1",
    "expectedDuration": "30s",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "custParams": "param1=value1&param2=value2",
    "ptpln": "podtemplate"
  }
}

প্রতিক্রিয়া

HTTP/1.1 200 OK

{
  "assetKey": "asset1",
  "expectedDuration": "30s",
  "custParams": "param1=value1&param2=value2",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "ptpln": "podtemplate",
  "daiBreakId": 1
}

নমুনা বাস্তবায়ন (পাইথন)

from __future__ import absolute_import
from __future__ import division
from __future__ import print_function

from absl import app

from google.auth.transport.requests import AuthorizedSession
from google.oauth2 import service_account

SERVICE_ACCOUNT_KEY_FILE = "~/eabn_key.json"
ASSET_KEY = "asset1"

SCOPES = ['https://www.googleapis.com/auth/video-ads']
EABN_API_URL = 'https://dai.googleapis.com/v1/adBreaks'


def main():
  credentials = service_account.Credentials.from_service_account_file(
      SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES)

  authed_session = AuthorizedSession(credentials)

  data = {
      'assetKey': ASSET_KEY,
      'expectedDuration': '120s',
      'custParams': 'param1=value1&param2=value2',
      'scte35CueOut': '/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==',
  }

  r = authed_session.post(EABN_API_URL, json={'adBreak': data})
  print(r.status_code)
  print(r.headers)
  print(r.text)

if __name__ == '__main__':
  app.run(main)