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)
  }
}
الحقول
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

شكل المجموعة الإعلانية.

عمليات التعداد
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

أنواع طرق مطابقة المنتجات.

عمليات التعداد
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

مفتاح التصنيف المخصص

عمليات التعداد
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

 يسرد المجموعات الإعلانية.