REST Resource: advertisers.youtubeAdGroups

المرجع: YoutubeAdGroup

مجموعة إعلانية واحدة على YouTube مرتبطة بعنصر YouTube والشركاء

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "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 بايت كحد أقصى.
youtubeAdIds[]

string (int64 format)

أرقام تعريف موارد [youtube_ad_group_ad][] المرتبطة بالمجموعة الإعلانية.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

شكل الإعلانات في المجموعة الإعلانية.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

استراتيجية عروض الأسعار المستخدَمة من قِبل المجموعة الإعلانية.
entityStatus

enum (EntityStatus)

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

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

object (TargetingExpansionConfig)

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

لا ينطبق هذا الإعداد إلا عند تحديد استهداف قائمة الجمهور المؤهَّلة للمجموعة الإعلانية.
productFeedData

object (ProductFeedData)

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

YoutubeAndPartnersAdGroupFormat

شكل المجموعة الإعلانية على YouTube.

عمليات التعداد
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED لم يتم تحديد قيمة التنسيق أو هي غير معروفة في هذا الإصدار.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM الإعلانات أثناء عرض الفيديو
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY الإعلانات ضمن الخلاصة
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER إعلانات الملصقات الصغيرة
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM الإعلانات غير القابلة للتخطي أثناء عرض الفيديو
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO الإعلانات الصوتية غير القابلة للتخطّي أثناء عرض الفيديو
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION الإعلانات المتجاوبة في "حملات الفيديو الإجرائية"
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH المجموعات الإعلانية لميزة "مدى الوصول الفعّال"، بما في ذلك الإعلانات أثناء عرض الفيديو وإعلانات الملصقات الصغيرة
YOUTUBE_AND_PARTNERS_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

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

get

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

list

 يعرض المجموعات الإعلانية على YouTube.