Method: listPlannableProducts

عرض قائمة أشكال الإعلانات على YouTube القابلة للتخطيط لكل موقع جغرافي مع الاستهداف المسموح به.

قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v16:listPlannableProducts

يستخدم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

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

string

مطلوبة. رقم تعريف الموقع الجغرافي المحدّد للتخطيط. لإدراج أرقام تعريف المواقع الجغرافية القابلة للتخطيط المتاحة، استخدِم ReachPlanService.ListPlannableLocations.

نص الاستجابة

ردّ يتضمّن كل المنتجات المتوفّرة.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
الحقول
productMetadata[]

object (ProductMetadata)

قائمة المنتجات المتاحة للتخطيط والبيانات الوصفية للاستهداف ذات الصلة.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

ProductMetadata

البيانات الوصفية المرتبطة بمنتج متوفّر قابل للتخطيط

تمثيل JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
الحقول
plannableProductName

string

الاسم المرتبط بالمنتج الإعلاني.
plannableTargeting

object (PlannableTargeting)

الاستهداف القابل للتخطيط المسموح به لهذا المنتج.
plannableProductCode

string

الرمز المرتبط بمنتج الإعلان (مثل: BUMPER وTRUEVIEW_IN_Stream). لإدراج رموز المنتجات القابلة للتخطيط، استخدِم ReachPlanService.ListPlannableProducts.

PlannableTargeting

الاستهداف الذي سيتم إعداد تقارير مقاييس الزيارات له.

تمثيل JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
الحقول
ageRanges[]

enum (ReachPlanAgeRange)

الفئات العمرية المسموح لها بالتخطيط للمنتج التي سيتم إعداد تقارير بالمقاييس الخاصة بها. يتم احتساب الاستهداف الفعلي من خلال ربط هذه الفئة العمرية في قيم Googlecommon.AgeRangeInfo العادية.
genders[]

object (GenderInfo)

أجناس قابلة للاستهداف للمنتج الإعلاني.
devices[]

object (DeviceInfo)

أجهزة قابلة للاستهداف من أجل المنتج الإعلاني يتم تطبيق استهداف أجهزة TABLET تلقائيًا على المقاييس المبلّغ عنها عند اختيار استهداف الأجهزة الجوّالة لمنتجات CPM_MASThead وGOOGLE_PREFERRED_BUMPER وGOOGLE_PREFERRED_SHORT.
networks[]

enum (ReachPlanNetwork)

شبكات قابلة للاستهداف من أجل المنتج الإعلاني
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

قوائم YouTube Select القابلة للاستهداف للمنتج الإعلاني.
surfaceTargeting

object (SurfaceTargetingCombinations)

مجموعات مساحات عرض قابلة للاستهداف لمنتج الإعلان

YouTubeSelectLineUp

قائمة YouTube Select قابلة للتخطيط لاستهداف المنتجات.

تمثيل JSON 
{
  "lineupId": string,
  "lineupName": string
}
الحقول
lineupId

string (int64 format)

رقم تعريف قائمة YouTube Select
lineupName

string

الاسم الفريد لقائمة YouTube Select.

SurfaceTargetingCombinations

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

تمثيل JSON 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
الحقول
defaultTargeting

object (SurfaceTargeting)

تم تطبيق استهداف مساحة العرض التلقائي على منتج الإعلان.
availableTargetingCombinations[]

object (SurfaceTargeting)

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