Method: videoAdvertisingOptions.getEnabledAds

একটি নির্দিষ্ট অংশীদার- বা ব্যবহারকারীর আপলোড করা ভিডিওর জন্য অনুমোদিত বিজ্ঞাপনের প্রকারগুলি সম্পর্কে বিশদ পুনরুদ্ধার করে৷

HTTP অনুরোধ

GET https://youtubepartner.googleapis.com/youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
videoId

string

videoId প্যারামিটারটি ভিডিওটির YouTube ভিডিও আইডি নির্দিষ্ট করে যার জন্য আপনি বিজ্ঞাপনের বিকল্পগুলি পুনরুদ্ধার করছেন৷

ক্যোয়ারী প্যারামিটার

পরামিতি
onBehalfOfContentOwner

string

onBehalfOfContentOwner প্যারামিটার সেই সামগ্রীর মালিককে চিহ্নিত করে যার পক্ষে ব্যবহারকারী কাজ করছেন৷ এই প্যারামিটার ব্যবহারকারীদের সমর্থন করে যাদের অ্যাকাউন্ট একাধিক বিষয়বস্তুর মালিকদের সাথে যুক্ত।

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

অনুরোধের বডি খালি হতে হবে।

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

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

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "kind": string,
  "countriesRestriction": [
    {
      object (CountriesRestriction)
    }
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "adsOnEmbeds": boolean,
  "id": string
}
ক্ষেত্র
kind

string

API সম্পদের ধরন। এই সম্পদের জন্য, মান হল youtubePartner#videoAdvertisingOptionGetEnabledAds

countriesRestriction[]

object ( CountriesRestriction )

একটি তালিকা যা সেই দেশগুলিকে চিহ্নিত করে যেখানে বিজ্ঞাপনগুলি চলতে পারে এবং সেই দেশগুলিতে অনুমোদিত বিজ্ঞাপনের ধরন৷

adBreaks[]

object ( AdBreak )

দাবিকৃত YouTube ভিডিওতে বিজ্ঞাপন বিরতির একটি তালিকা।

adsOnEmbeds

boolean

এই ক্ষেত্রটি নির্দেশ করে যে ভিডিওটি এমবেডেড প্লেয়ারে চালানো হলে YouTube বিজ্ঞাপন দেখাতে পারে কিনা।

id

string

ইউটিউব যে আইডি ব্যবহার করে দাবি করা ভিডিওটিকে অনন্যভাবে শনাক্ত করতে ব্যবহার করে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/youtubepartner

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

দেশ সীমাবদ্ধতা

প্রয়োগ করা নীতির উপর ভিত্তি করে প্রদত্ত দেশগুলিতে ফর্ম্যাটগুলি সক্ষম করা হয়েছে৷

JSON প্রতিনিধিত্ব
{
  "adFormats": [
    string
  ],
  "territories": [
    string
  ]
}
ক্ষেত্র
adFormats[]

string

বিজ্ঞাপন ফর্ম্যাটের একটি তালিকা যা নির্দিষ্ট দেশে ব্যবহার করা যেতে পারে।

territories[]

string

ISO 3166-1 alpha-2 দেশের কোডগুলির একটি তালিকা যা বিজ্ঞাপনগুলি সক্ষম করা দেশগুলিকে চিহ্নিত করে৷