REST Resource: adBreak.networks.assets.adBreaks

উৎস: AdBreak

একটি লাইভ ভিডিও ইভেন্টে বিজ্ঞাপন বিরতির জন্য বিজ্ঞাপন নির্ধারণ করতে বিজ্ঞাপন বিরতির মেটাডেটা ব্যবহার করা হয়।

JSON উপস্থাপনা 
{
  "name": string,
  "createTime": string,
  "expectedDuration": string,
  "customParams": string,
  "scte35CueOut": string,
  "podTemplateName": string,
  "breakState": enum (BreakState),
  "expectedStartTime": string,
  "expireDuration": string,
  "breakSequence": string,
  "breakParams": {
    object (BreakParams)
  },
  "matchParams": {
    object (MatchParams)
  },
  "servedBreak": {
    object (ServedBreak)
  }
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। বিজ্ঞাপন বিরতির রিসোর্স নাম। এই ফিল্ডটির ফরম্যাট হবে "networks/{network_code}/assets/{asset_key}/adBreaks/{adBreakId}"।

network_code হলো গুগল অ্যাড ম্যানেজারের সেই নেটওয়ার্ক কোড, যার অধীনে এই কন্টেন্টটি রয়েছে।

asset_key হলো গুগল অ্যাড ম্যানেজ-এ থাকা লাইভ স্ট্রিম ইভেন্টের কী, যার অধীনে অ্যাড ব্রেকটি তৈরি করা হয়েছিল।

adBreakId হলো বিজ্ঞাপন বিরতির মূল চাবিকাঠি। শুধুমাত্র আউটপুটের জন্য।

createTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। বিজ্ঞাপন বিরতি তৈরির সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

expectedDuration

string ( Duration format)

প্রয়োজনীয়। প্রত্যাশিত বিরতির সময়কাল।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

customParams
(deprecated)

string

ঐচ্ছিক। অ্যাড ম্যানেজারে কাস্টম ক্রাইটেরিয়া টার্গেটিংয়ের জন্য এই ব্রেকের অ্যাড রিকোয়েস্টে অন্তর্ভুক্ত করার জন্য কী-ভ্যালু পেয়ার। উদাহরণ: 'key1=value&key2=value2,value22' অপ্রচলিত: অনুগ্রহ করে "cust_params" কী ব্যবহার করে breakParams.ad_tag_params-এ cust_params সেট করুন।

scte35CueOut

string

ঐচ্ছিক। scte35 কিউ আউট থেকে প্রাপ্ত বেস 64 এনকোডেড ডেটা। এতে splice_insert() বা time_signal() কমান্ড অন্তর্ভুক্ত থাকতে পারে। উদাহরণ: - time_signal() সহ: “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - splice_insert() সহ: "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="

podTemplateName
(deprecated)

string

ঐচ্ছিক। গুগল অ্যাড ম্যানেজার পড টেমপ্লেটের নাম। অপ্রচলিত: অনুগ্রহ করে breakParams.ad_tag_params-এ 'ptpln' কী ব্যবহার করে cust_params সেট করুন।

breakState

enum ( BreakState )

শুধুমাত্র আউটপুট। বিজ্ঞাপন বিরতির বর্তমান অবস্থা।

expectedStartTime

string ( Timestamp format)

ঐচ্ছিক। বিজ্ঞাপন বিরতির প্রত্যাশিত শুরুর সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

expireDuration

string ( Duration format)

ঐচ্ছিক। এটি expectedStartTime + expireDuration সময়ে বিজ্ঞাপন বিরতির মেয়াদ শেষ করে। যদি expectedStartTime সেট করা না থাকে, তাহলে সিদ্ধান্ত গ্রহণ শুরু হওয়ার expireDuration সময় পরে বিজ্ঞাপন বিরতির মেয়াদ শেষ হবে। ডিফল্ট: ৩০ মিনিট, সর্বনিম্ন: ৫ মিনিট, সর্বোচ্চ: ৬ ঘণ্টা।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

breakSequence

string ( int64 format)

শুধুমাত্র আউটপুট। এটি বিজ্ঞাপন বিরতির মিডরোল সিকোয়েন্স আইডি। যদি mridx কী-সহ breakParams.ad_tag_params-এর মাধ্যমে স্পষ্টভাবে উল্লেখ করা হয়, তবে একাধিক বিজ্ঞাপন বিরতির একই breakSequence থাকতে পারে। এটি কার্যকরভাবে দুটি GAM বিজ্ঞাপন বিরতিকে সংযুক্ত করে।

breakParams

object ( BreakParams )

ঐচ্ছিক। এই বিরতির জন্য বিজ্ঞাপনের অনুরোধে বিরতির শর্তাবলী অন্তর্ভুক্ত করতে হবে।

matchParams

object ( MatchParams )

ঐচ্ছিক। API-এর মাধ্যমে তৈরি একটি অ্যাড ব্রেক কীভাবে একটি ইন-ম্যানিফেস্ট অ্যাড ব্রেকের সাথে মেলানো হবে, তা নির্ধারণ করতে স্টিচড DAI-এর জন্য এটি ব্যবহৃত হয়। যখন একটি নতুন ব্রেক শনাক্ত করা হয়, তখন একটি ইভেন্টের সেই সমস্ত অ্যাড ব্রেকের বিরুদ্ধে একটি ম্যাচ ফাংশন চালানো হবে, যেগুলোর breakState হলো SCHEDULED বা DECISIONED এর মাধ্যমে পরীক্ষা করা হবে যে, অ্যাড ব্রেকটির matchParams-এ সেট করা সমস্ত প্যারামিটার শনাক্ত করা ব্রেকটির সাথে মেলে কি না। নিম্নলিখিত শর্তগুলোর যেকোনো একটি পূরণ হলে একটি ম্যাচ ঘটে: ১. অ্যাড ব্রেকটিতে একটি matchParams ফিল্ড থাকে এবং এতে সেট করা সমস্ত প্যারামিটার নতুন ব্রেকটির সাথে মেলে। ২. অ্যাড ব্রেকটি DECISIONED থাকে এবং এতে কোনো matchParams ফিল্ড থাকে না।

অনিচ্ছাকৃত "ম্যাচ-অল" আচরণ (যা একটি খালি কিন্তু উপস্থিত matchParams-এর ক্ষেত্রে ঘটতে পারে) রোধ করার জন্য, সেট করা থাকলে matchParams খালি থাকতে পারে না। যদি ফিল্ডটি কোনো অনুরোধে উপস্থিত থাকে, তবে এর নিজস্ব ফিল্ডগুলোর মধ্যে অন্তত একটি অবশ্যই সেট করা থাকতে হবে।

অ্যাড ব্রেকগুলো এই ক্রমে যাচাই করা হয়: ১. ম্যাচপ্যারামস সহ, যেখানে এক্সপেক্টেডস্টার্টটাইম ও ক্রিয়েটটাইম ঊর্ধ্বক্রমে সাজানো হয় এবং সাজানোর সময় এক্সপেক্টেডস্টার্টটাইম ছাড়া অ্যাড ব্রেকগুলোকে অগ্রাধিকার দেওয়া হয় ২. ম্যাচপ্যারামস ছাড়া, যেখানে এক্সপেক্টেডস্টার্টটাইম ও ক্রিয়েটটাইম ঊর্ধ্বক্রমে সাজানো হয় এবং সাজানোর সময় এক্সপেক্টেডস্টার্টটাইম ছাড়া অ্যাড ব্রেকগুলোকে অগ্রাধিকার দেওয়া হয়

যদি সমস্ত মুলতুবি থাকা EABN-গুলো না মেলে, তাহলে DAI পরবর্তী উপলব্ধ মিডরোল সূচক ব্যবহার করে JIT সিদ্ধান্ত গ্রহণ পদ্ধতিতে ফিরে যাবে।

servedBreak

object ( ServedBreak )

শুধুমাত্র আউটপুট। এটি পরিবেশিত বিজ্ঞাপন বিরতির প্রকৃত তথ্য প্রতিফলিত করে। শুধুমাত্র COMPLETE breakState যুক্ত বিজ্ঞাপন বিরতির জন্য সেট করা হয়।

ব্রেকস্টেট

বিজ্ঞাপন বিরতির অবস্থা।

এনাম
BREAK_STATE_UNSPECIFIED বিজ্ঞাপন বিরতির অবস্থা অজানা।
BREAK_STATE_DECISIONED বিজ্ঞাপন বিরতির সিদ্ধান্ত গ্রহণ শুরু হয়েছে, কিন্তু এখনও ব্যবহারকারীদের কাছে তা পৌঁছে দেওয়া হয়নি।
BREAK_STATE_COMPLETE বিজ্ঞাপন বিরতিটি ব্যবহারকারীদের কাছে পৌঁছে দেওয়া হয়েছে।
BREAK_STATE_SCHEDULED বিজ্ঞাপন বিরতিটি সিদ্ধান্ত গ্রহণের জন্য নির্ধারিত হয়েছে।
BREAK_STATE_EXPIRED বিজ্ঞাপন বিরতিটির মেয়াদ শেষ হয়ে গেছে এবং এটি ব্যবহারযোগ্য নয়। ডিফল্টরূপে, বিজ্ঞাপন বিরতিগুলো expectedStartTime-এর ৩০ মিনিট পর, অথবা expectedStartTime সেট করা না থাকলে বিজ্ঞাপন বিরতিটির সিদ্ধান্ত গ্রহণ শুরু হওয়ার ৩০ মিনিট পর শেষ হয়ে যাবে। expireDuration ফিল্ডটি ব্যবহার করে মেয়াদ শেষ হওয়ার সময় স্পষ্টভাবে সেট করা যেতে পারে।

ব্রেকপ্যারামস

বিজ্ঞাপন বিরতির সাথে সম্পর্কিত প্যারামিটারসমূহ।

JSON উপস্থাপনা 
{
  "macros": [
    {
      object (KeyValue)
    }
  ],
  "adTagParams": [
    {
      object (KeyValue)
    }
  ]
}
ক্ষেত্র
macros[]

object ( KeyValue )

ঐচ্ছিক। কাস্টম ম্যাক্রো মান যা অ্যাড ট্যাগের একটি যথেচ্ছ প্লেসহোল্ডারকে প্রতিস্থাপন করে। অ্যাড অনুরোধের সময়, DAI অ্যাড ট্যাগ ম্যাক্রোগুলিকে %%DAI_PATTERN:[MACRO_KEY]%% আকারে প্রসারিত করবে, যেখানে MACRO_KEY হলো কী।

সেট করা থাকলে, এই ম্যাক্রোগুলি পড সার্ভিং অনুরোধে সেট করা ম্যাক্রোগুলির চেয়ে অগ্রাধিকার পাবে।

adTagParams[]

object ( KeyValue )

ঐচ্ছিক। মূল বিজ্ঞাপন অনুরোধে বিজ্ঞাপন ট্যাগ প্যারামিটারগুলোকে অগ্রাহ্য করে।

যদি cust_params সেট করা Pod Serving অনুরোধগুলির আগে এটি ট্রিগার হয়, তবে সিদ্ধান্ত গ্রহণের জন্য এগুলি ব্যবহৃত হয়।

সাধারণত, ব্রেকের জন্য প্যারামিটারগুলো মূল অ্যাড রিকোয়েস্টের কোয়েরি স্ট্রিং প্যারামিটারকে ওভাররাইড করে। কাস্টম ইউআরএল ফরম্যাটযুক্ত কিছু অ্যাড সার্ভারের ক্ষেত্রে, অ্যাড সার্ভারের প্রয়োজনীয়তা পূরণের জন্য প্যারামিটারগুলো অ্যাড ট্যাগের নির্দিষ্ট স্থানকে ওভাররাইড করতে পারে। AdBreak-এ 'mridx' ভ্যালুটি সেট করলে, যদি তা একটি বৈধ ধনাত্মক পূর্ণসংখ্যা হয়, তবে প্রদত্ত ভ্যালুটি দিয়ে breakSequence ফিল্ডটি ওভাররাইড হয়ে যাবে। এটি নন-GAM অ্যাড সার্ভারের ক্ষেত্রেও প্রযোজ্য।

সেট করা হলে, এই প্যারামিটারগুলো একটি পড সার্ভিং অনুরোধে সেট করা প্যারামিটারগুলোর চেয়ে অগ্রাধিকার পাবে।

মূলমান

একটি কী-ভ্যালু পেয়ারকে বোঝায়।

JSON উপস্থাপনা 
{
  "key": string,
  "value": string
}
ক্ষেত্র
key

string

প্রয়োজনীয়। এই কী-ভ্যালু পেয়ারটির কী।

value

string

প্রয়োজনীয়। এই কী-ভ্যালু পেয়ারটির মান।

ম্যাচপ্যারামস

শনাক্তকৃত স্টিচড ডিএআই বিজ্ঞাপন বিরতির সাথে মেলানোর জন্য প্যারামিটারসমূহ।

JSON উপস্থাপনা 
{
  "scte35Binary": string,
  "scte35Upid": string,
  "scte35EventId": integer,
  "breakDuration": boolean
}
ক্ষেত্র
scte35Binary

string

ঐচ্ছিক। SCTE-35 বাইনারি। এই ফিল্ডটি মেলানোর জন্য, ইন-ম্যানিফেস্ট অ্যাড ব্রেকটিতে অবশ্যই একই SCTE-35 বাইনারি স্ট্রিং (বেস৬৪-এনকোডেড) থাকতে হবে। এটি খালি থাকলে, এই অংশটি বাদ দেওয়া হয়।

scte35Upid

string

ঐচ্ছিক। SCTE-35 UPID (ইউনিক প্রোগ্রাম আইডেন্টিফায়ার)। এই ফিল্ডটি মেলানোর জন্য, ইন-ম্যানিফেস্ট অ্যাড ব্রেকে অবশ্যই একই SCTE-35 UPID থাকতে হবে। UPID হলো একটি ভ্যালু যা SCTE-35 বাইনারি থেকে পার্স করা হয়। এটি খালি থাকলে, এই অংশটি বাদ দেওয়া হয়।

scte35EventId

integer ( uint32 format)

ঐচ্ছিক। SCTE-35 ইভেন্ট আইডি। এই ফিল্ডটি মেলানোর জন্য, ইন-ম্যানিফেস্ট অ্যাড ব্রেকের ইভেন্ট আইডি (স্প্লাইস ইভেন্ট আইডি/সেগমেন্টেশন ইভেন্ট আইডি) অবশ্যই একই হতে হবে। ইভেন্ট আইডি হলো একটি ভ্যালু যা SCTE-35 বাইনারি থেকে পার্স করা হয়। এটি খালি থাকলে, এই অংশটি বাদ দেওয়া হয়।

breakDuration

boolean

ঐচ্ছিক। বিরতির সময়কাল। এই ফিল্ডের সাথে মিল রাখতে, ইন-ম্যানিফেস্ট বিজ্ঞাপন বিরতির সময়কাল অবশ্যই 'Ad Break'-এর 'expectedDuration'-এর সমান হতে হবে, যেখানে ১ মিলিসেকেন্ডের একটি সহনশীলতা থাকবে। যদি 'false' হয়, তবে এটি এড়িয়ে যাওয়া হবে।

পরিবেশিত বিরতি

পরিবেশিত বিজ্ঞাপন বিরতির প্রকৃত তথ্য উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "breakDetectTime": string,
  "detectedDuration": string,
  "scte35CueOut": string
}
ক্ষেত্র
breakDetectTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যে সময়ে সংশ্লিষ্ট বিজ্ঞাপন বিরতিটি শনাক্ত করা হয়। পড সার্ভিং-এর ক্ষেত্রে, এটি হলো সেই সময় যখন বিজ্ঞাপন পড-এর প্রথম সেগমেন্ট/ম্যানিফেস্টের জন্য অনুরোধ করা হয়। স্টিচড ডিএআই-এর ক্ষেত্রে, এটি হলো সেই সময় যখন ম্যানিফেস্টে বিজ্ঞাপন বিরতিটি প্রথমবার শনাক্ত করা হয়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

detectedDuration

string ( Duration format)

শুধুমাত্র আউটপুট। শনাক্তকৃত সময়কালটি সংশ্লিষ্ট বিজ্ঞাপন বিরতিতে পাঠানো হয়েছে।

সেকেন্ডে পরিমাপকৃত সময়কাল, যা সর্বোচ্চ নয়টি ভগ্নাংশ অঙ্ক পর্যন্ত হতে পারে এবং শেষে ' s ' থাকে। উদাহরণ: "3.5s" ।

scte35CueOut

string

শুধুমাত্র আউটপুট। শনাক্তকৃত বেস৬৪-এনকোডেড SCTE-35 বার্তাটি সংশ্লিষ্ট বিজ্ঞাপন বিরতিতে পাঠানো হয়েছে।

পদ্ধতি

create

 লাইভ স্ট্রিমের মধ্যে বিজ্ঞাপন বিরতি তৈরি করার এপিআই।

delete

 লাইভ স্ট্রিমের মধ্যে বিজ্ঞাপন বিরতি মুছে ফেলার এপিআই।

get

 লাইভ স্ট্রিমের মধ্যে বিজ্ঞাপন বিরতি পাওয়ার জন্য এপিআই।

list

 লাইভ স্ট্রিমের মধ্যে বিজ্ঞাপন বিরতি তালিকাভুক্ত করার এপিআই।

patch

 লাইভ স্ট্রিমের মধ্যে বিজ্ঞাপন বিরতি আপডেট করার জন্য এপিআই।