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)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  }
}
الحقول
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 وdemandGenBid فقط في استراتيجية عروض الأسعار.
entityStatus

enum (EntityStatus)

الحقل مطلوب. يتحكّم هذا الإعداد في ما إذا كان بإمكان المجموعة الإعلانية إنفاق ميزانيتها وتقديم عروض أسعار على المستودع الإعلاني.

إذا لم يكن عنصر الحملة الرئيسي للمجموعة الإعلانية نشطًا، لا يمكن للمجموعة الإعلانية إنفاق ميزانيتها حتى إذا كانت حالتها ENTITY_STATUS_ACTIVE.
targetingExpansion

object (TargetingExpansionConfig)

اختيارية: إعدادات الاستهداف المحسّن للمجموعة الإعلانية
productFeedData

object (ProductFeedData)

اختيارية: إعدادات خلاصة المنتجات في هذه المجموعة الإعلانية
adGroupInventoryControl

object (AdGroupInventoryControl)

اختيارية: مطلوب للمجموعات الإعلانية في "حملات زيادة الطلب". تحدّد هذه السمة عنصر التحكّم في المستودع الإعلاني للمجموعة الإعلانية.

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 الرئيسية
AD_GROUP_FORMAT_DEMAND_GEN "إعلانات زيادة الطلب"

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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
الحقول
تمثّل هذه السمة السمة والقيمة اللتين يجب أن يتطابق معهما المنتج. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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

AdGroupInventoryControl

عنصر التحكّم في المستودع الإعلاني للمجموعة الإعلانية.

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
الحقول
عنصر التحكّم في المستودع الإعلاني للمجموعة الإعلانية. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

استراتيجية المستودع
selectedInventories

object (SelectedInventories)

المساحات الإعلانية المحدّدة
نهاية الحقول التي يستبعد كلّ منها الآخر

AdGroupInventoryStrategy

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

عمليات التعداد
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED غير محدّد أو غير معروف
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY تم تفعيل عرض المجموعة الإعلانية على جميع المساحات الإعلانية في Google و"شبكة Google الإعلانية".
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY تم تفعيل جميع المساحات الإعلانية في Google للمجموعة الإعلانية.

SelectedInventories

عنصر التحكّم في المستودع الإعلاني للمجموعة الإعلانية.

تمثيل JSON 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
الحقول
allowYoutubeStream

boolean

تُستخدَم لتحديد ما إذا كانت المجموعة الإعلانية قد فعّلت مساحة العرض "إعلانات أثناء عرض الفيديو" على YouTube.
allowYoutubeShorts

boolean

تُستخدَم لتحديد ما إذا كانت المجموعة الإعلانية قد فعّلت مستودع YouTube Shorts الإعلاني.
allowYoutubeFeed

boolean

تُستخدَم لتحديد ما إذا كانت المجموعة الإعلانية قد فعّلت مساحة العرض "ضمن الخلاصة" على YouTube.
allowDiscover

boolean

تُستخدَم لتحديد ما إذا كانت المجموعة الإعلانية قد فعّلت مساحة العرض في "اكتشف".
allowGmail

boolean

تُستخدَم لتحديد ما إذا كانت المجموعة الإعلانية قد فعّلت مساحة العرض الإعلاني على Gmail.
allowGoogleDisplayNetwork

boolean

تحدّد هذه السمة ما إذا كانت المجموعة الإعلانية قد فعّلت عرض إعلاناتها على المساحات المتوفّرة في "شبكة Google الإعلانية".

الطُرق

bulkEditAssignedTargetingOptions

 تعديلات مجمّعة تستهدف خيارات مجموعات إعلانية متعدّدة

bulkListAssignedTargetingOptions

 قوائم خيارات الاستهداف المحدّدة لمجموعات إعلانية متعدّدة على مستوى أنواع الاستهداف

create

 تُنشئ هذه الطريقة مجموعة إعلانية جديدة.

delete

 تحذف هذه الطريقة مجموعة إعلانية.

get

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

list

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

patch

 تعديل مجموعة إعلانية حالية