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

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