Method: advertisers.reachForecast.retrievePlannableProducts

تعرض هذه الطريقة قائمة بالمنتجات التي يمكن التخطيط لها في موقع جغرافي معيّن.

طلب HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableProducts

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

مَعلمات المسار

المعلمات
advertiserId

string (int64 format)

الحقل مطلوب. معرّف المعلِن الذي سيتم عرض المنتجات القابلة للتخطيط له.

مَعلمات طلب البحث

المعلمات
plannableLocationId

string

الحقل مطلوب. معرّف الموقع الجغرافي القابل للتخطيط.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

استجابة reachForecast.retrievePlannableProducts

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

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

object (ProductMetadata)

النتائج فقط. قائمة البيانات الوصفية للمنتج التي تعرض إمكانات الاستهداف

نطاقات الأذونات

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

  • https://www.googleapis.com/auth/display-video

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

ProductMetadata

البيانات الوصفية لمنتج يمكن التخطيط له.

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

string

النتائج فقط. الوصف النصي العادي لمنتج الإعلان
plannableProductCode

string

النتائج فقط. رمز المنتج القابل للتخطيط (مثل "YOUTUBE_REACH_MIX").
plannableTargeting

object (PlannableTargeting)

النتائج فقط. تمثّل هذه السمة إمكانات الاستهداف المتاحة لهذا المنتج.
displayName

string

النتائج فقط. اسم المنتج الإعلاني. على سبيل المثال: "حملة لمشاهدة الفيديو".
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

النتائج فقط. السمات الأساسية لهذا المنتج

PlannableTargeting

إمكانات استهداف منتج معيّن

تمثيل JSON 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
الحقول
ageRanges[]

enum (PlannableAgeRange)

النتائج فقط. تمثّل هذه السمة الفئات العمرية المسموح بتخطيطها للمنتج. يتم احتساب الاستهداف الفعلي من خلال ربط هذه الفئة العمرية بالاستهداف حسب الفئة العمرية العادي في Google.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

النتائج فقط. مجموعات مساحات العرض التي يمكن استهدافها لمنتج الإعلان
genders[]

enum (Gender)

النتائج فقط. الجنس الذي يمكن استهدافه لمنتج الإعلان.
networks[]

enum (PlannableNetwork)

النتائج فقط. الشبكات التي يمكن استهدافها لمنتج الإعلان
devices[]

enum (DeviceType)

النتائج فقط. الأجهزة التي يمكن استهدافها لمنتج الإعلان
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

النتائج فقط. قوائم YouTube Select التي يمكن استهدافها لمنتج الإعلان
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

النتائج فقط. تمثّل هذه السمة قائمة YouTube Select التلقائية لهذا المنتج، إذا كان ذلك منطبقًا.

SurfaceTargetingCombinations

قواعد استهداف مواضع الظهور

تمثيل JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
الحقول
availableSurfaceTypes[]

enum (PlannableSurface)

النتائج فقط. أنواع مساحات العرض المتاحة
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

النتائج فقط. مجموعات صالحة من مساحات العرض يمكن اختيارها معًا
defaultSurfaceTypes[]

enum (PlannableSurface)

النتائج فقط. أنواع مساحات العرض التلقائية لهذا المنتج

SurfaceTargetingCombination

مجموعة صالحة من مساحات العرض

تمثيل JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
الحقول
choices[]

enum (PlannableSurface)

النتائج فقط. مجموعة من الأسطح

YouTubeSelectLineUp

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

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

string (int64 format)

النتائج فقط. رقم تعريف قائمة YouTube Select
displayName

string

النتائج فقط. تمثّل هذه السمة الاسم المعروض لقائمة YouTube Select.

PlannableProductCoreAttributes

السمات الأساسية لمنتج يمكن التخطيط له

تمثيل JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
الحقول
productCategory

enum (PlannableProductCategory)

النتائج فقط. فئة المنتج
buyingMethod

enum (PlannableBuyingMethod)

النتائج فقط. طريقة الشراء
costModel

enum (PlannableCostModel)

النتائج فقط. نموذج التكلفة

PlannableBuyingMethod

تمثّل هذه السمة طريقة شراء منتج يمكن التخطيط له.

عمليات التعداد
PLANNABLE_BUYING_METHOD_UNSPECIFIED لم يتم تحديد أي قيمة.
PLANNABLE_BUYING_METHOD_AUCTION المزاد
PLANNABLE_BUYING_METHOD_RESERVATION الحجز

PlannableCostModel

تمثّل هذه السمة نموذج التكلفة الخاص بالمنتج القابل للتخطيط.

عمليات التعداد
PLANNABLE_COST_MODEL_UNSPECIFIED لم يتم تحديد أي قيمة.
PLANNABLE_COST_MODEL_CPM لكل ألف ظهور.
PLANNABLE_COST_MODEL_CPV تكلفة المشاهدة
PLANNABLE_COST_MODEL_CPC تكلفة النقرة
PLANNABLE_COST_MODEL_CPA التكلفة لكل إجراء