REST Resource: advertisers.adGroups

রিসোর্স: AdGroup

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

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)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
ফিল্ড
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)

ঐচ্ছিক। ডিমান্ড জেনারেশন বিজ্ঞাপন গ্রুপের জন্য প্রয়োজন। বিজ্ঞাপন গ্রুপের ইনভেন্টরি কন্ট্রোল নির্দিষ্ট করে।

adSource

enum (AdSource)

ঐচ্ছিক। এই বিজ্ঞাপন গ্রুপের অধীনে থাকা বিজ্ঞাপনের সোর্স। কোনও নির্দিষ্ট সোর্স থেকে অটোমেটিক বিজ্ঞাপন তৈরি করা হলে তবেই এই ফিল্ড ব্যবহার করা হয়।

creativeAssignments[]

object (CreativeAssignment)

ঐচ্ছিক। বিজ্ঞাপন গ্রুপের অধীনে বিজ্ঞাপন তৈরি করতে ব্যবহৃত ক্রিয়েটিভ।

adSource AD_SOURCE_DV360_CREATIVE হলে তবেই এই ফিল্ড অ্যাসাইন করা যাবে।

AdGroupFormat

বিজ্ঞাপন গ্রুপের ফর্ম্যাট।

Enums
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 YouTube হোমপেজের উপরের স্লটে দেখানো মাস্টহেড বিজ্ঞাপন।
AD_GROUP_FORMAT_DEMAND_GEN ডিমান্ড জেনারেশন বিজ্ঞাপন।

ProductFeedData

প্রোডাক্ট ফিডের বিবরণ।

JSON উপস্থাপনা
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
ফিল্ড
productMatchType

enum (ProductMatchType)

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

productMatchDimensions[]

object (ProductMatchDimension)

প্রোডাক্ট ম্যাচ করার জন্য ব্যবহৃত ডাইমেনশনের তালিকা।

isFeedDisabled

boolean

প্রোডাক্ট ফিড প্রোডাক্ট দেখানোর বিকল্প থেকে অপ্ট-আউট করেছে কিনা।

ProductMatchType

প্রোডাক্ট ম্যাচ করার পদ্ধতির ধরন।

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED নির্দিষ্ট করে উল্লেখ করা নেই বা অজানা।
PRODUCT_MATCH_TYPE_ALL_PRODUCTS সব প্রোডাক্ট মিলে গেছে।
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS নির্দিষ্ট প্রোডাক্ট বেছে নেওয়া হয়েছে।
PRODUCT_MATCH_TYPE_CUSTOM_LABEL কাস্টম লেবেল অনুযায়ী প্রোডাক্ট ম্যাচ করুন।

ProductMatchDimension

প্রোডাক্ট ম্যাচ করার জন্য ব্যবহৃত ডাইমেনশন।

JSON উপস্থাপনা
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
ফিল্ড
প্রোডাক্টের সাথে ম্যাচ করার জন্য ডাইমেনশন ও ভ্যালু। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
productOfferId

string

একই অফার আইডি সহ প্রোডাক্টের সাথে ম্যাচ করার জন্য প্রোডাক্ট অফারের আইডি।

customLabel

object (CustomLabel)

লেবেল সহ সব প্রোডাক্টের সাথে ম্যাচ করার জন্য কাস্টম লেবেল।

মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

CustomLabel

কাস্টম লেবেলের কী ও ভ্যালু।

JSON উপস্থাপনা
{
  "key": enum (CustomLabelKey),
  "value": string
}
ফিল্ড
key

enum (CustomLabelKey)

লেবেলের কী।

value

string

লেবেলের মান।

CustomLabelKey

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

Enums
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 উপস্থাপনা
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
ফিল্ড
বিজ্ঞাপন গ্রুপের ইনভেনটরি কন্ট্রোল। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

ইনভেনটরি স্ট্র্যাটেজি।

selectedInventories

object (SelectedInventories)

বেছে নেওয়া ইনভেনটরি।

মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

AdGroupInventoryStrategy

বিজ্ঞাপন গ্রুপের জন্য ইনভেনটরি স্ট্র্যাটেজি।

Enums
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED নির্দিষ্ট করে উল্লেখ করা নেই বা অজানা।
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY বিজ্ঞাপন গ্রুপটি সমস্ত Google এবং Display Network ইনভেনটরিতে অপ্ট-ইন করা আছে।
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY বিজ্ঞাপন গ্রুপটি সমস্ত Google ইনভেনটরিতে অপ্ট-ইন করা আছে।

SelectedInventories

বিজ্ঞাপন গ্রুপের ইনভেনটরি কন্ট্রোল।

JSON উপস্থাপনা
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
ফিল্ড
allowYoutubeStream

boolean

বিজ্ঞাপন গ্রুপটি YouTube ইন-স্ট্রিম ইনভেনটরিতে অপ্ট-ইন করা আছে কিনা।

allowYoutubeShorts

boolean

বিজ্ঞাপন গ্রুপটি YouTube Shorts ইনভেনটরিতে অপ্ট-ইন করা আছে কিনা।

allowYoutubeFeed

boolean

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

allowDiscover

boolean

বিজ্ঞাপন গ্রুপটি Discover ইনভেনটরিতে অপ্ট-ইন করা আছে কিনা।

allowGmail

boolean

বিজ্ঞাপন গ্রুপ Gmail ইনভেনটরিতে অপ্ট-ইন করেছে কিনা।

allowGoogleDisplayNetwork

boolean

বিজ্ঞাপন গ্রুপ Google Display Network ইনভেনটরিতে অপ্ট-ইন করেছে কিনা।

AdSource

এই adGroup-এর অধীনে থাকা বিজ্ঞাপনের সোর্স।

Enums
AD_SOURCE_UNSPECIFIED নির্দিষ্ট করে উল্লেখ করা নেই বা অজানা। ডিফল্ট হিসেবে সাধারণ বিজ্ঞাপন সোর্স।
AD_SOURCE_DV360_CREATIVE DV360 ক্রিয়েটিভ থেকে সোর্স করা হয়েছে।

CreativeAssignment

বিজ্ঞাপন গ্রুপে অ্যাসাইন করা ক্রিয়েটিভের বিবরণ।

JSON উপস্থাপনা
{
  "creativeId": string
}
ফিল্ড
creativeId

string (int64 format)

প্রয়োজনীয়। বিজ্ঞাপন গ্রুপে অ্যাসাইন করা Display & Video 360 ক্রিয়েটিভের আইডি।

পদ্ধতি

bulkEditAssignedTargetingOptions

একাধিক বিজ্ঞাপন গ্রুপের জন্য বাল্ক এডিট টার্গেটিং বিকল্প।

bulkListAssignedTargetingOptions

টার্গেটিংয়ের ধরন জুড়ে একাধিক বিজ্ঞাপন গ্রুপের জন্য অ্যাসাইন করা টার্গেটিং বিকল্পের তালিকা।

create

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

delete

AdGroup মুছে দেয়।

get

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

list

বিজ্ঞাপন গ্রুপের তালিকা দেখায়।

patch

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