Method: advertisers.reachForecast.retrievePlannableProducts

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

طلب HTTP

GET https://displayvideo.googleapis.com/v5/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 التكلفة لكل إجراء