Method: listPlannableProducts

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

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v15: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)

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

object (GenderInfo)

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

object (DeviceInfo)

أجهزة قابلة للاستهداف من أجل المنتج الإعلاني يتمّ تطبيق استهداف أجهزة الأجهزة اللوحية تلقائيًا على المقاييس المبلّغ عنها عند اختيار استهداف الأجهزة الجوّالة للمنتجات 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)

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