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 )

اختیاری. برای گروه‌های تبلیغاتی Demand Gen الزامی است. کنترل موجودی گروه تبلیغاتی را مشخص می‌کند.

قالب گروه تبلیغاتی

قالب گروه تبلیغاتی.

انوم‌ها
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.
}
فیلدها
فیلد Union 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 شاخص کلیدی ۴.

کنترل موجودی گروه تبلیغاتی

کنترل موجودی گروه تبلیغاتی.

نمایش 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.
}
فیلدها
فیلد Union 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 این گروه تبلیغاتی در تمام موجودی‌های گوگل و شبکه نمایش (Display Network) ثبت شده است.
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

اینکه آیا گروه تبلیغاتی در فهرست محصولات Discover ثبت نام کرده است یا خیر.

allowGmail

boolean

اینکه آیا گروه تبلیغاتی در فهرست موجودی جیمیل ثبت شده است یا خیر.

allowGoogleDisplayNetwork

boolean

اینکه آیا گروه تبلیغاتی در فهرست موجودی شبکه نمایش گوگل (Google Display Network) ثبت شده است یا خیر.

روش‌ها

bulkEditAssignedTargetingOptions

 گزینه‌های هدف‌گیری ویرایش‌های انبوه برای چندین گروه تبلیغاتی.

bulkListAssignedTargetingOptions

 گزینه‌های هدف‌گیری اختصاص داده شده برای چندین گروه تبلیغاتی در انواع مختلف هدف‌گیری را فهرست می‌کند.

create

 یک گروه تبلیغاتی جدید ایجاد می‌کند.

delete

 یک گروه تبلیغاتی را حذف می‌کند.

get

 یک گروه تبلیغاتی دریافت می‌کند.

list

 گروه‌های تبلیغاتی را فهرست می‌کند.

patch

 یک گروه تبلیغاتی موجود را به‌روزرسانی می‌کند.