REST Resource: adBreak.networks.customAssets.adBreaks

রিসোর্স: অ্যাডব্রেক

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

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 হল Google Ad Manager-এর সেই নেটওয়ার্ক কোড যার সাথে এই কন্টেন্ট সম্পর্কিত।

asset_key হল Google Ad Management-এর লাইভ স্ট্রিম ইভেন্টের কী যার অধীনে অ্যাড ব্রেক তৈরি করা হয়েছিল।

অ্যাডব্রেকআইডি হল অ্যাড ব্রেকের মূল চাবিকাঠি। শুধুমাত্র আউটপুট।

createTime

string ( Timestamp format)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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

ঐচ্ছিক। Google Ad Manager পড টেমপ্লেটের নাম। বাতিল করা হয়েছে: "ptpln" কী ব্যবহার করে breakParams.ad_tag_params-এ cust_params সেট করুন।

breakState

enum ( BreakState )

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

expectedStartTime

string ( Timestamp format)

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

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "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 শেষ হবে। ডিফল্ট: 30m সর্বনিম্ন: 5m সর্বোচ্চ: 6h

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

breakSequence

string ( int64 format)

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

breakParams

object ( BreakParams )

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

matchParams

object ( MatchParams )

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

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

বিজ্ঞাপন বিরতিগুলি এই ক্রমে পরীক্ষা করা হয়: 1. matchParams সহ, ​​expectedStartTime ঊর্ধ্বমুখী অনুসারে ক্রমানুসারে, createTime ঊর্ধ্বমুখী অনুসারে, যেখানে expectedStartTime ছাড়া বিজ্ঞাপন বিরতিগুলি সাজানোর সময় অগ্রাধিকার দেওয়া হয় 2. matchParams ছাড়াই, expectedStartTime ঊর্ধ্বমুখী অনুসারে ক্রমানুসারে, createTime ঊর্ধ্বমুখী অনুসারে ক্রমানুসারে, যেখানে expectedStartTime ছাড়া বিজ্ঞাপন বিরতিগুলি সাজানোর সময় অগ্রাধিকার দেওয়া হয়

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

servedBreak

object ( ServedBreak )

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

পদ্ধতি

create

 লাইভ স্ট্রিমের মধ্যে একটি অ্যাড ব্রেক তৈরি করার জন্য API।

delete

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

get

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

list

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

patch

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