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)
  },
  "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 
{

  // 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

AdGroupInventoryControl

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

تمثيل JSON 
{

  // Union field inventory_controls can be only one of the following:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of list of possible types for union field inventory_controls.
}
الحقول
حقل الربط inventory_controls عنصر التحكّم في المستودع الإعلاني للمجموعة الإعلانية. يمكن أن يكون التعليق inventory_controls إحدى القيم التالية فقط:
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

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

object (SelectedInventories)

المستودعات المحدّدة

AdGroupInventoryStrategy

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

عمليات التعداد
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED غير محدّد أو غير معروف
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY تم تفعيل عرض المجموعة الإعلانية على جميع المساحات الإعلانية في 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

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

boolean

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

boolean

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

boolean

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

boolean

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

الطُرق

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

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

delete

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

get

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

list

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

patch

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