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)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
الحقول
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)

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

enum (AdSource)

اختيارية: مصدر الإعلانات ضمن هذه المجموعة الإعلانية لا يُستخدَم هذا الحقل إلا عند إنشاء الإعلانات تلقائيًا من مصدر معيّن.
creativeAssignments[]

object (CreativeAssignment)

اختيارية: تصاميم الإعلانات المستخدَمة لإنشاء إعلانات ضمن المجموعة الإعلانية

لا يمكن تخصيص هذا الحقل إلا إذا كانت قيمة adSource هي AD_SOURCE_DV360_CREATIVE.

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 و"الشبكة الإعلانية".
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 الإعلانية"

AdSource

مصدر الإعلانات ضمن هذه المجموعة الإعلانية

عمليات التعداد
AD_SOURCE_UNSPECIFIED غير محدّد أو غير معروف يتم ضبطه تلقائيًا على مصدر إعلان عادي.
AD_SOURCE_DV360_CREATIVE مصدرها تصميم إعلان في "مساحة العرض والفيديو 360"

CreativeAssignment

تفاصيل تصميم إعلان تم إسناده إلى المجموعة الإعلانية

تمثيل JSON 
{
  "creativeId": string
}
الحقول
creativeId

string (int64 format)

الحقل مطلوب. رقم تعريف تصميم الإعلان في "مساحة العرض والفيديو 360" الذي تمّ تعيينه للمجموعة الإعلانية

الطُرق

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

create

 لإنشاء مجموعة إعلانية جديدة

delete

 لحذف مجموعة إعلانية

get

 للحصول على مجموعة إعلانية

list

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

patch

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