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

قالب گروه آگهی.

شمارشی‌ها
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

انواع روش‌های مطابقت دادن محصولات.

شمارشی‌ها
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

کلید برچسب سفارشی

شمارشی‌ها
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

استراتژی موجودی برای گروه آگهی.

شمارشی‌ها
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED مشخص‌نشده یا ناشناخته.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY گروه آگهی برای همه فضاهای آگهی Google و «شبکه تبلیغات» موافقت کرده است.
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 موافقت کرده است یا نه.
allowYoutubeFeed

boolean

اینکه گروه آگهی برای موجودی YouTube در فید موافقت کرده است یا نه.
allowDiscover

boolean

اینکه گروه آگهی برای فضای آگهی «یافته‌ها» موافقت کرده است یا نه.
allowGmail

boolean

اینکه گروه آگهی با فضای آگهی Gmail موافقت کرده است یا نه.
allowGoogleDisplayNetwork

boolean

اینکه گروه آگهی برای فضای آگهی «شبکه تبلیغات Google» موافقت کرده است یا نه.

AdSource

منبع آگهی‌های تحت این adGroup.

شمارشی‌ها
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

 گروه آگهی موجود را به‌روز می‌کند.