REST Resource: advertisers.youtubeAdGroups

منبع: YoutubeAdGroup

یک گروه آگهی YouTube منفرد مرتبط با یک مورد خط YouTube و Partners.

نمایندگی JSON
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "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 بایت کدگذاری شود.

youtubeAdIds[]

string ( int64 format)

شناسه‌های منابع [youtube_ad_group_ad][] مرتبط با گروه آگهی.

adGroupFormat

enum ( YoutubeAndPartnersAdGroupFormat )

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

biddingStrategy

object ( YoutubeAndPartnersBiddingStrategy )

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

entityStatus

enum ( EntityStatus )

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

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

targetingExpansion

object ( TargetingExpansionConfig )

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

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

productFeedData

object ( ProductFeedData )

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

YoutubeAndPartnersAdGroupFormat

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

Enums
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED مقدار فرمت در این نسخه مشخص نشده یا ناشناخته است.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM تبلیغات درون جریانی
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY تبلیغات درون فید.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER تبلیغات باپر.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM تبلیغات درون جریانی غیرقابل رد شدن
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO تبلیغات صوتی در جریان غیرقابل رد شدن.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION تبلیغات واکنشگرا برای کمپین های اکشن ویدیویی .
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH گروه‌های تبلیغاتی مؤثر ، از جمله تبلیغات درون جریانی و بامپر.
YOUTUBE_AND_PARTNERS_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

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

get

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

list

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