সতর্কতা: আপনি API এর REST ইন্টারফেসের জন্য ডকুমেন্টেশন দেখছেন। আমাদের বেশিরভাগ অফিসিয়াল ক্লায়েন্ট লাইব্রেরি জিআরপিসি ব্যবহার করে। বিস্তারিত জানার জন্য REST ভূমিকা দেখুন।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

AdGroup

JSON প্রতিনিধিত্ব
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
দর্শক সেটিং
- JSON প্রতিনিধিত্ব

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

JSON প্রতিনিধিত্ব

JSON প্রতিনিধিত্ব
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

ক্ষেত্র
`resourceName`	`string` অপরিবর্তনীয়। বিজ্ঞাপন গোষ্ঠীর সম্পদের নাম। বিজ্ঞাপন গ্রুপ রিসোর্স নামের ফর্ম আছে: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum ( AdGroupStatus )` বিজ্ঞাপন গোষ্ঠীর অবস্থা।
`type`	`enum ( AdGroupType )` অপরিবর্তনীয়। বিজ্ঞাপন গ্রুপের ধরন।
`adRotationMode`	`enum ( AdGroupAdRotationMode )` বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন ঘূর্ণন মোড।
`urlCustomParameters[]`	`object ( CustomParameter )` একটি `trackingUrlTemplate` , `finalUrls` বা `mobile_final_urls` এ কাস্টম প্যারামিটার ট্যাগ প্রতিস্থাপন করতে ব্যবহৃত ম্যাপিংয়ের তালিকা।
`optimizedTargetingEnabled`	`boolean` অপ্টিমাইজ করা টার্গেটিং সক্ষম হলে সত্য৷ অপ্টিমাইজড টার্গেটিং হল শ্রোতা সম্প্রসারণের প্রতিস্থাপন।
`displayCustomBidDimension`	`enum ( TargetingDimension )` বিজ্ঞাপনদাতাদের একটি টার্গেটিং মাত্রা নির্দিষ্ট করার অনুমতি দেয় যার উপর নিখুঁত বিড স্থাপন করা যায়। এটি শুধুমাত্র সেই প্রচারাভিযানের জন্য প্রযোজ্য যেগুলি শুধুমাত্র ডিসপ্লে নেটওয়ার্ককে টার্গেট করে এবং অনুসন্ধান করে না।
`targetingSetting`	`object ( TargetingSetting )` সম্পর্কিত বৈশিষ্ট্য লক্ষ্য করার জন্য সেটিং.
`audienceSetting`	`object ( AudienceSetting )` অপরিবর্তনীয়। শ্রোতা সম্পর্কিত বৈশিষ্ট্যগুলির জন্য সেট করা।
`effectiveTargetCpaSource`	`enum ( BiddingSource )` শুধুমাত্র আউটপুট। কার্যকরী লক্ষ্য CPA এর উৎস। এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।
`effectiveTargetRoasSource`	`enum ( BiddingSource )` শুধুমাত্র আউটপুট। কার্যকরী লক্ষ্য ROAS এর উৎস। এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।
`labels[]`	`string` শুধুমাত্র আউটপুট। এই বিজ্ঞাপন গোষ্ঠীর সাথে সংযুক্ত লেবেলের সম্পদের নাম।
`excludedParentAssetFieldTypes[]`	`enum ( AssetFieldType )` এই বিজ্ঞাপন গ্রুপ থেকে বাদ দেওয়া উচিত যে সম্পদ ক্ষেত্রের ধরন. এই ক্ষেত্র প্রকারের সাথে সম্পদ লিঙ্কগুলি উপরের স্তর থেকে এই বিজ্ঞাপন গোষ্ঠীর দ্বারা উত্তরাধিকারসূত্রে পাওয়া যাবে না৷
`excludedParentAssetSetTypes[]`	`enum ( AssetSetType )` এই বিজ্ঞাপন গ্রুপ থেকে বাদ দেওয়া উচিত যে সম্পদ সেট প্রকার. এই ধরনের সম্পদ সেট লিঙ্ক উপরের স্তর থেকে এই বিজ্ঞাপন গ্রুপ দ্বারা উত্তরাধিকারসূত্রে পাওয়া যাবে না. অবস্থান গোষ্ঠীর প্রকারগুলি (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, এবং STATIC_LOCATION_GROUP) হল LOCATION_SYNC-এর চাইল্ড প্রকার৷ তাই, এই ক্ষেত্রের জন্য LOCATION_SYNC সেট করা থাকলে, সমস্ত অবস্থান গোষ্ঠীর সম্পদ সেটগুলিকে এই বিজ্ঞাপন গোষ্ঠীর সাথে লিঙ্ক করার অনুমতি দেওয়া হয় না এবং সমস্ত অবস্থান এক্সটেনশন (LE) এবং অ্যাফিলিয়েট লোকেশন এক্সটেনশনগুলি (ALE) এই বিজ্ঞাপন গোষ্ঠীর অধীনে পরিবেশিত হবে না৷ শুধুমাত্র LOCATION_SYNC বর্তমানে সমর্থিত৷
`id`	`string ( int64 format)` শুধুমাত্র আউটপুট। বিজ্ঞাপন গ্রুপের আইডি।
`name`	`string` বিজ্ঞাপন গ্রুপের নাম। এই ক্ষেত্রটি প্রয়োজন এবং নতুন বিজ্ঞাপন গোষ্ঠী তৈরি করার সময় খালি থাকা উচিত নয়৷ এটিতে অবশ্যই 255টির কম UTF-8 পূর্ণ-প্রস্থ অক্ষর থাকতে হবে। এতে অবশ্যই কোনো নাল (কোড পয়েন্ট 0x0), NL লাইন ফিড (কোড পয়েন্ট 0xA) বা ক্যারেজ রিটার্ন (কোড পয়েন্ট 0xD) অক্ষর থাকবে না।
`baseAdGroup`	`string` শুধুমাত্র আউটপুট। খসড়া বা পরীক্ষামূলক বিজ্ঞাপন গোষ্ঠীগুলির জন্য, এই ক্ষেত্রটি হল বেস বিজ্ঞাপন গোষ্ঠীর সংস্থানের নাম যেখান থেকে এই বিজ্ঞাপন গোষ্ঠীটি তৈরি করা হয়েছিল৷ যদি একটি খসড়া বা পরীক্ষামূলক বিজ্ঞাপন গোষ্ঠীতে একটি বেস বিজ্ঞাপন গোষ্ঠী না থাকে, তাহলে এই ক্ষেত্রটি শূন্য। বেস বিজ্ঞাপন গোষ্ঠীর জন্য, এই ক্ষেত্রটি বিজ্ঞাপন গোষ্ঠীর সম্পদ নামের সমান। এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।
`trackingUrlTemplate`	`string` একটি ট্র্যাকিং URL তৈরি করার জন্য URL টেমপ্লেট৷
`campaign`	`string` অপরিবর্তনীয়। যে প্রচারাভিযানটি বিজ্ঞাপন গোষ্ঠীর অন্তর্গত।
`cpcBidMicros`	`string ( int64 format)` সর্বোচ্চ CPC (প্রতি-ক্লিকের খরচ) বিড।
`effectiveCpcBidMicros`	`string ( int64 format)` শুধুমাত্র আউটপুট। যখন বিডিং কৌশলটি ম্যানুয়াল cpc, বর্ধিত cpc, পৃষ্ঠা ওয়ান প্রচারিত বা লক্ষ্য আউটর্যাঙ্ক শেয়ারের একটি হলে CPC (প্রতি-ক্লিক-প্রতি-মূল্য) বিড মানের মতই হবে, অন্যথায় মানটি শূন্য হবে।
`cpmBidMicros`	`string ( int64 format)` সর্বোচ্চ CPM (প্রতি হাজারে দর্শনযোগ্য ইম্প্রেশনের খরচ) বিড।
`targetCpaMicros`	`string ( int64 format)` লক্ষ্য CPA (প্রতি-অধিগ্রহণ খরচ)। যদি বিজ্ঞাপন গোষ্ঠীর প্রচারাভিযানের বিডিং কৌশলটি হয় TargetCpa বা Maximize Conversions (তার targetCpa ফিল্ড সেট সহ), তাহলে এই ক্ষেত্রটি প্রচারাভিযানের বিডিং কৌশলে নির্দিষ্ট করা লক্ষ্য CPAকে ওভাররাইড করে। অন্যথায়, এই মান উপেক্ষা করা হয়.
`cpvBidMicros`	`string ( int64 format)` CPV (প্রতি-ভিউ খরচ) বিড।
`targetCpmMicros`	`string ( int64 format)` মাইক্রোতে গড় পরিমাণ যা বিজ্ঞাপনদাতা প্রতি হাজার বার বিজ্ঞাপন দেখানোর জন্য দিতে ইচ্ছুক।
`targetRoas`	`number` লক্ষ্য ROAS (বিজ্ঞাপন-ব্যয়-অন-প্রতিটা) ওভাররাইড। যদি বিজ্ঞাপন গোষ্ঠীর প্রচারাভিযানের বিডিং কৌশলটি হয় TargetRoas বা MaximizeConversionValue (এর সাথে এর targetRoas ফিল্ড সেট), তাহলে এই ক্ষেত্রটি প্রচারাভিযানের বিডিং কৌশলে নির্দিষ্ট করা টার্গেট ROAS কে ওভাররাইড করে। অন্যথায়, এই মান উপেক্ষা করা হয়.
`percentCpcBidMicros`	`string ( int64 format)` শতাংশ cpc বিডের পরিমাণ, কিছু পণ্য বা পরিষেবার জন্য বিজ্ঞাপনী মূল্যের একটি ভগ্নাংশ হিসাবে প্রকাশ করা হয়। ভগ্নাংশের জন্য বৈধ পরিসর হল [0,1) এবং এখানে সংরক্ষিত মান হল 1,000,000 * [ভগ্নাংশ]।
`finalUrlSuffix`	`string` ফাইনাল ইউআরএলে প্যারাম যোগ করার জন্য ইউআরএল টেমপ্লেট।
`effectiveTargetCpaMicros`	`string ( int64 format)` শুধুমাত্র আউটপুট। কার্যকর লক্ষ্য CPA (প্রতি-অধিগ্রহণের খরচ)। এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।
`effectiveTargetRoas`	`number` শুধুমাত্র আউটপুট। কার্যকর টার্গেট ROAS (বিজ্ঞাপন-ব্যয়-এর উপর রিটার্ন)। এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।

AdGroupStatus

একটি বিজ্ঞাপন গোষ্ঠীর সম্ভাব্য অবস্থা।

এনামস
`UNSPECIFIED`	অবস্থা নির্দিষ্ট করা হয়নি.
`UNKNOWN`	প্রাপ্ত মান এই সংস্করণে জানা নেই. এটি একটি প্রতিক্রিয়া শুধুমাত্র মান.
`ENABLED`	বিজ্ঞাপন গ্রুপ সক্রিয় করা হয়েছে.
`PAUSED`	বিজ্ঞাপন গ্রুপ বিরাম দেওয়া হয়েছে.
`REMOVED`	বিজ্ঞাপন গ্রুপ সরানো হয়.

AdGroupType

Enum একটি বিজ্ঞাপন গ্রুপ সম্ভাব্য ধরনের তালিকা.

এনামস
`UNSPECIFIED`	ধরন নির্দিষ্ট করা হয়নি।
`UNKNOWN`	প্রাপ্ত মান এই সংস্করণে জানা নেই. এটি একটি প্রতিক্রিয়া শুধুমাত্র মান.
`SEARCH_STANDARD`	অনুসন্ধান প্রচারাভিযানের জন্য ডিফল্ট বিজ্ঞাপন গ্রুপ প্রকার।
`DISPLAY_STANDARD`	প্রদর্শন প্রচারাভিযানের জন্য ডিফল্ট বিজ্ঞাপন গোষ্ঠীর ধরন।
`SHOPPING_PRODUCT_ADS`	শপিং প্রচারাভিযানের জন্য বিজ্ঞাপন গোষ্ঠীর ধরন যা মানক পণ্য বিজ্ঞাপন পরিবেশন করে।
`HOTEL_ADS`	হোটেল প্রচারাভিযানের জন্য ডিফল্ট বিজ্ঞাপন গোষ্ঠীর ধরন।
`SHOPPING_SMART_ADS`	স্মার্ট শপিং প্রচারাভিযানে বিজ্ঞাপন গোষ্ঠীর ধরন।
`VIDEO_BUMPER`	সংক্ষিপ্ত এড়ানো যায় না ইন-স্ট্রীম ভিডিও বিজ্ঞাপন।
`VIDEO_TRUE_VIEW_IN_STREAM`	TrueView (এড়িয়ে যাওয়া যায়) ইন-স্ট্রীম ভিডিও বিজ্ঞাপন।
`VIDEO_TRUE_VIEW_IN_DISPLAY`	TrueView ইন-ডিসপ্লে ভিডিও বিজ্ঞাপন।
`VIDEO_NON_SKIPPABLE_IN_STREAM`	এড়িয়ে যাওয়া যায় না ইন-স্ট্রীম ভিডিও বিজ্ঞাপন।
`VIDEO_OUTSTREAM`	আউটস্ট্রিম ভিডিও বিজ্ঞাপন.
`SEARCH_DYNAMIC_ADS`	ডায়নামিক সার্চ বিজ্ঞাপন বিজ্ঞাপন গোষ্ঠীর জন্য বিজ্ঞাপন গোষ্ঠীর ধরন।
`SHOPPING_COMPARISON_LISTING_ADS`	শপিং তুলনা তালিকা প্রচারাভিযানে বিজ্ঞাপন গোষ্ঠীর ধরন।
`PROMOTED_HOTEL_ADS`	প্রচারিত হোটেল বিজ্ঞাপন গোষ্ঠীগুলির জন্য বিজ্ঞাপন গোষ্ঠীর ধরন৷
`VIDEO_RESPONSIVE`	ভিডিও প্রতিক্রিয়াশীল বিজ্ঞাপন গ্রুপ.
`VIDEO_EFFICIENT_REACH`	ভিডিও দক্ষ নাগাল বিজ্ঞাপন গ্রুপ.
`SMART_CAMPAIGN_ADS`	স্মার্ট প্রচারাভিযানের জন্য বিজ্ঞাপন গোষ্ঠীর ধরন।
`TRAVEL_ADS`	ভ্রমণ প্রচারাভিযানের জন্য বিজ্ঞাপন গ্রুপ প্রকার।

AdGroupAdRotationMode

একটি বিজ্ঞাপন গোষ্ঠীর সম্ভাব্য বিজ্ঞাপন ঘূর্ণন মোড।

এনামস
`UNSPECIFIED`	বিজ্ঞাপন ঘূর্ণন মোড নির্দিষ্ট করা হয়নি.
`UNKNOWN`	প্রাপ্ত মান এই সংস্করণে জানা নেই. এটি একটি প্রতিক্রিয়া শুধুমাত্র মান.
`OPTIMIZE`	ক্লিক বা রূপান্তরের উপর ভিত্তি করে বিজ্ঞাপন গোষ্ঠী বিজ্ঞাপনগুলি অপ্টিমাইজ করুন৷
`ROTATE_FOREVER`	চিরকাল সমানভাবে ঘোরান।

দর্শক সেটিং

দর্শকদের লক্ষ্য করার জন্য সেটিংস।

JSON প্রতিনিধিত্ব
{ "useAudienceGrouped": boolean }

ক্ষেত্র

ক্ষেত্র
`useAudienceGrouped`	`boolean` অপরিবর্তনীয়। সত্য হলে, এই বিজ্ঞাপন গোষ্ঠীটি দর্শকদের লক্ষ্য করার জন্য একটি শ্রোতা সংস্থান ব্যবহার করে। মিথ্যা হলে, এই বিজ্ঞাপন গোষ্ঠী পরিবর্তে দর্শক বিভাগের মানদণ্ড ব্যবহার করতে পারে।

useAudienceGrouped

boolean

অপরিবর্তনীয়। সত্য হলে, এই বিজ্ঞাপন গোষ্ঠীটি দর্শকদের লক্ষ্য করার জন্য একটি শ্রোতা সংস্থান ব্যবহার করে। মিথ্যা হলে, এই বিজ্ঞাপন গোষ্ঠী পরিবর্তে দর্শক বিভাগের মানদণ্ড ব্যবহার করতে পারে।