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.