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

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