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.