REST Resource: advertisers.adGroups

সূত্র: অ্যাডগ্রুপ

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

JSON উপস্থাপনা
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  }
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। শনাক্তকারী। বিজ্ঞাপন গ্রুপের রিসোর্স নাম।

advertiserId

string ( int64 format)

শুধুমাত্র আউটপুট। বিজ্ঞাপনদাতার অনন্য আইডি, যার অধীনে বিজ্ঞাপন গোষ্ঠীটি রয়েছে।

adGroupId

string ( int64 format)

শুধুমাত্র আউটপুট। বিজ্ঞাপন গ্রুপের অনন্য আইডি। সিস্টেম দ্বারা নির্ধারিত।

lineItemId

string ( int64 format)

আবশ্যক। অপরিবর্তনীয়। যে লাইন আইটেমটিতে বিজ্ঞাপন গ্রুপটি অন্তর্ভুক্ত, তার অনন্য আইডি।

displayName

string

আবশ্যক। বিজ্ঞাপন গ্রুপের প্রদর্শিত নাম।

অবশ্যই UTF-8 এনকোডেড হতে হবে এবং এর সর্বোচ্চ আকার হবে ২৫৫ বাইট।

adGroupFormat

enum ( AdGroupFormat )

আবশ্যক। অপরিবর্তনীয়। অ্যাড গ্রুপের বিজ্ঞাপনগুলোর ফরম্যাট।

bidStrategy

object ( BiddingStrategy )

ঐচ্ছিক। বিজ্ঞাপন গ্রুপ দ্বারা ব্যবহৃত বিডিং কৌশল। বিডিং কৌশলে শুধুমাত্র youtubeAndPartnersBid এবং demandGenBid ফিল্ড ব্যবহার করা যাবে।

entityStatus

enum ( EntityStatus )

আবশ্যক। এটি নিয়ন্ত্রণ করে যে বিজ্ঞাপন গোষ্ঠীটি তার বাজেট ব্যয় করতে এবং ইনভেন্টরির জন্য বিড করতে পারবে কি না।

যদি অ্যাড গ্রুপের প্যারেন্ট লাইন আইটেমটি সক্রিয় না থাকে, তাহলে অ্যাড গ্রুপটির নিজের স্ট্যাটাস ENTITY_STATUS_ACTIVE হলেও সেটি তার বাজেট খরচ করতে পারে না।

targetingExpansion

object ( TargetingExpansionConfig )

ঐচ্ছিক। অ্যাড গ্রুপের অপ্টিমাইজ করা টার্গেটিং সেটিংস।

productFeedData

object ( ProductFeedData )

ঐচ্ছিক। এই বিজ্ঞাপন গোষ্ঠীর পণ্য ফিডের সেটিংস।

adGroupInventoryControl

object ( AdGroupInventoryControl )

ঐচ্ছিক। ডিমান্ড জেন অ্যাড গ্রুপের জন্য আবশ্যক। এটি অ্যাড গ্রুপটির ইনভেন্টরি নিয়ন্ত্রণ নির্দিষ্ট করে।

AdGroupFormat

বিজ্ঞাপন গোষ্ঠীর বিন্যাস।

এনাম
AD_GROUP_FORMAT_UNSPECIFIED এই সংস্করণে ফরম্যাটের মান নির্দিষ্ট করা নেই বা তা অজানা।
AD_GROUP_FORMAT_IN_STREAM স্ট্রিমের মধ্যে বিজ্ঞাপন।
AD_GROUP_FORMAT_VIDEO_DISCOVERY ইন-ফিড বিজ্ঞাপন।
AD_GROUP_FORMAT_BUMPER বাম্পার বিজ্ঞাপন।
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM স্ট্রিমের মধ্যে দেখানো বিজ্ঞাপন যা স্কিপ করা যাবে না।
AD_GROUP_FORMAT_AUDIO স্ট্রিমের মধ্যে এমন অডিও বিজ্ঞাপন যা স্কিপ করা যাবে না।
AD_GROUP_FORMAT_RESPONSIVE রেসপন্সিভ বিজ্ঞাপন।
AD_GROUP_FORMAT_REACH কার্যকরী রিচ অ্যাড গ্রুপ , যার মধ্যে ইন-স্ট্রিম এবং বাম্পার অ্যাড অন্তর্ভুক্ত।
AD_GROUP_FORMAT_MASTHEAD মাস্টহেড বিজ্ঞাপন যা ইউটিউব হোমপেজের শীর্ষস্থানে প্রদর্শিত হয়।
AD_GROUP_FORMAT_DEMAND_GEN

ডিমান্ড জেন বিজ্ঞাপন।

প্রোডাক্টফিডডেটা

পণ্য সরবরাহের বিবরণ।

JSON উপস্থাপনা
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
ক্ষেত্র
productMatchType

enum ( ProductMatchType )

প্রোডাক্ট ফিডের মাধ্যমে কীভাবে পণ্য নির্বাচন করা হয়

productMatchDimensions[]

object ( ProductMatchDimension )

পণ্য মেলানোর জন্য ব্যবহৃত মাপের একটি তালিকা।

isFeedDisabled

boolean

প্রোডাক্ট ফিডটি পণ্য দেখানো থেকে বিরত থেকেছে কিনা।

পণ্যের মিলের ধরণ

পণ্য মেলানোর পদ্ধতির প্রকারভেদ।

এনাম
PRODUCT_MATCH_TYPE_UNSPECIFIED অনির্দিষ্ট বা অজানা।
PRODUCT_MATCH_TYPE_ALL_PRODUCTS সমস্ত পণ্যগুলো মেলানো হয়েছে।
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS নির্দিষ্ট পণ্য নির্বাচন করা হয়।
PRODUCT_MATCH_TYPE_CUSTOM_LABEL পণ্যগুলোকে তাদের নিজস্ব লেবেল দেখে মেলান।

প্রোডাক্টম্যাচডাইমেনশন

পণ্য মেলানোর জন্য ব্যবহৃত একটি মাত্রা।

JSON উপস্থাপনা
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড dimension । যে ডাইমেনশন এবং মানের উপর ভিত্তি করে পণ্যটিকে মেলানো হবে। dimension নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
productOfferId

string

একই অফার আইডিযুক্ত পণ্যের সাথে মেলানোর জন্য পণ্য অফারের আইডি।

customLabel

object ( CustomLabel )

সমস্ত পণ্যের সাথে মেলানোর জন্য কাস্টম লেবেল।

কাস্টম লেবেল

কাস্টম লেবেলের চাবিকাঠি ও গুরুত্ব।

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

enum ( CustomLabelKey )

লেবেলের চাবি।

value

string

লেবেলটির মান।

কাস্টম লেবেল কী

কাস্টম লেবেলের চাবি

এনাম
CUSTOM_LABEL_KEY_UNSPECIFIED অনির্দিষ্ট বা অজানা।
CUSTOM_LABEL_KEY_0 মূল সূচক ০।
CUSTOM_LABEL_KEY_1 মূল সূচক ১।
CUSTOM_LABEL_KEY_2 মূল সূচক ২।
CUSTOM_LABEL_KEY_3 মূল সূচক ৩।
CUSTOM_LABEL_KEY_4 মূল সূচক ৪।

AdGroupInventoryControl

বিজ্ঞাপন গোষ্ঠীর মজুদ নিয়ন্ত্রণ।

JSON উপস্থাপনা
{

  // Union field inventory_controls can be only one of the following:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of list of possible types for union field inventory_controls.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড inventory_controls হলো অ্যাড গ্রুপের ইনভেন্টরি কন্ট্রোল। inventory_controls নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
adGroupInventoryStrategy

enum ( AdGroupInventoryStrategy )

মজুদ কৌশল।

selectedInventories

object ( SelectedInventories )

নির্বাচিত তালিকাগুলো।

অ্যাডগ্রুপইনভেন্টরিস্ট্র্যাটেজি

বিজ্ঞাপন গোষ্ঠীর জন্য ইনভেন্টরি কৌশল।

এনাম
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED অনির্দিষ্ট বা অজানা।
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY বিজ্ঞাপন গ্রুপটি গুগল এবং ডিসপ্লে নেটওয়ার্কের সমস্ত ইনভেন্টরির জন্য অপ্ট-ইন করা আছে।
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY বিজ্ঞাপন গ্রুপটি গুগলের সমস্ত ইনভেন্টরির জন্য অপ্ট-ইন করা আছে।

নির্বাচিত তালিকা

বিজ্ঞাপন গোষ্ঠীর মজুদ নিয়ন্ত্রণ।

JSON উপস্থাপনা
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
ক্ষেত্র
allowYoutubeStream

boolean

বিজ্ঞাপন গ্রুপটি ইউটিউব ইন-স্ট্রিম ইনভেন্টরিতে অংশগ্রহণের জন্য সম্মতি দিয়েছে কিনা।

allowYoutubeShorts

boolean

বিজ্ঞাপন গ্রুপটি ইউটিউব শর্টস ইনভেন্টরিতে অন্তর্ভুক্ত হয়েছে কিনা।

allowYoutubeFeed

boolean

বিজ্ঞাপন গ্রুপটি ইউটিউব ইন-ফিড ইনভেন্টরির জন্য অপ্ট-ইন করা আছে কিনা।

allowDiscover

boolean

বিজ্ঞাপন গোষ্ঠীটি ডিসকভার ইনভেন্টরিতে অন্তর্ভুক্ত হয়েছে কিনা।

allowGmail

boolean

বিজ্ঞাপন গ্রুপটি জিমেইল ইনভেন্টরিতে অন্তর্ভুক্ত হয়েছে কিনা।

allowGoogleDisplayNetwork

boolean

বিজ্ঞাপন গ্রুপটি গুগল ডিসপ্লে নেটওয়ার্ক ইনভেন্টরিতে অন্তর্ভুক্ত হয়েছে কিনা।

পদ্ধতি

bulkEditAssignedTargetingOptions

একাধিক অ্যাড গ্রুপের জন্য টার্গেটিং অপশনগুলো একসাথে সম্পাদনা করুন।

bulkListAssignedTargetingOptions

বিভিন্ন টার্গেটিং টাইপ অনুযায়ী একাধিক অ্যাড গ্রুপের জন্য নির্ধারিত টার্গেটিং অপশনগুলোর তালিকা দেখায়।

create

একটি নতুন বিজ্ঞাপন গ্রুপ তৈরি করে।

delete

একটি AdGroup মুছে ফেলে।

get

একটি বিজ্ঞাপন গ্রুপ পায়।

list

বিজ্ঞাপন গ্রুপগুলির তালিকা।

patch

বিদ্যমান বিজ্ঞাপন গ্রুপ আপডেট করে।