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)
  }
}
فیلدها
name

string

نام منبع گروه تبلیغاتی

advertiserId

string ( int64 format)

شناسه منحصر به فرد تبلیغ کننده ای که گروه تبلیغاتی به آن تعلق دارد.

adGroupId

string ( int64 format)

شناسه منحصر به فرد گروه تبلیغاتی. توسط سیستم تعیین شده است.

lineItemId

string ( int64 format)

شناسه منحصر به فرد مورد خطی که گروه تبلیغاتی به آن تعلق دارد.

displayName

string

نام نمایشی گروه تبلیغاتی

باید UTF-8 با حداکثر اندازه 255 بایت کدگذاری شود.

adGroupFormat

enum ( AdGroupFormat )

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

bidStrategy

object ( BiddingStrategy )

استراتژی پیشنهادی که توسط گروه تبلیغاتی استفاده می شود. فقط فیلد youtubeAndPartnersBid را می توان در استراتژی مناقصه استفاده کرد.

entityStatus

enum ( EntityStatus )

کنترل می کند که آیا گروه تبلیغاتی می تواند بودجه و پیشنهاد خود را برای موجودی هزینه کند یا خیر.

اگر مورد خط اصلی گروه آگهی فعال نباشد، گروه آگهی نمی‌تواند بودجه خود را خرج کند حتی اگر وضعیت خودش ENTITY_STATUS_ACTIVE باشد.

targetingExpansion

object ( TargetingExpansionConfig )

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

productFeedData

object ( ProductFeedData )

تنظیمات فید محصول در این گروه تبلیغاتی.

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 ظاهر می شود.

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
{

  // 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 )

برچسب سفارشی برای مطابقت با تمام محصولات با برچسب.

CustomLabel

کلید و ارزش یک برچسب سفارشی.

نمایندگی JSON
{
  "key": enum (CustomLabelKey),
  "value": string
}
فیلدها
key

enum ( CustomLabelKey )

کلید برچسب.

value

string

ارزش برچسب.

CustomLabelKey

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

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED مشخص یا ناشناخته
CUSTOM_LABEL_KEY_0 شاخص کلید 0.
CUSTOM_LABEL_KEY_1 شاخص کلید 1.
CUSTOM_LABEL_KEY_2 شاخص کلیدی 2.
CUSTOM_LABEL_KEY_3 شاخص کلید 3.
CUSTOM_LABEL_KEY_4 شاخص کلیدی 4.

روش ها

bulkListAdGroupAssignedTargetingOptions

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

get

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

list

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