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

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

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

 تعرض هذه السمة المجموعات الإعلانية.