REST Resource: adBreak.networks.assets.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 ব্রেকস্টেট সহ বিজ্ঞাপন বিরতির জন্য সেট করা।

ব্রেকস্টেট

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

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

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

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

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

object ( KeyValue )

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

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

adTagParams[]

object ( KeyValue )

ঐচ্ছিক। প্রাথমিক বিজ্ঞাপন অনুরোধে বিজ্ঞাপন ট্যাগ প্যারামিটারগুলিকে ওভাররাইড করে।

cust_params সেট সহ পড সার্ভিং অনুরোধের আগে এটি ট্রিগার হলে সিদ্ধান্ত নেওয়ার জন্য এগুলি ব্যবহার করা হয়।

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

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

কীভ্যালু

একটি মূল মান জোড়া প্রতিনিধিত্ব করে।

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

string

প্রয়োজনীয়। এই কী মান জোড়ার কী।

value

string

প্রয়োজনীয়। এই কী মান জোড়ার মান।

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

সনাক্ত করা স্টিচড DAI বিজ্ঞাপন বিরতির সাথে মেলানোর জন্য প্যারামিটার।

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

string

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

scte35Upid

string

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

scte35EventId

integer ( uint32 format)

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

breakDuration

boolean

ঐচ্ছিক। বিরতির সময়কাল। এই ক্ষেত্রটি মেলানোর জন্য, ইন-ম্যানিফেস্ট বিজ্ঞাপন বিরতির বিরতির সময়কাল বিজ্ঞাপন বিরতির প্রত্যাশিত সময়কালের সমান হতে হবে, যার সহনশীলতা 1 মিলিসেকেন্ড। যদি মিথ্যা হয়, তাহলে এটি এড়িয়ে যাওয়া হবে।

সার্ভডব্রেক

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

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

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" ।

detectedDuration

string ( Duration format)

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

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

scte35CueOut

string

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

পদ্ধতি

create

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

delete

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

get

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

list

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

patch

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