Method: advertisers.reachForecast.retrievePlannableLocations

يستردّ هذا الطلب قائمة البلدان التي تتوفّر فيها ميزة توقّع مدى الوصول.

طلب HTTP

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

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

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

المعلمات
advertiserId

string (int64 format)

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

نص الطلب

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

نص الاستجابة

الاستجابة لطلب reachForecast.retrievePlannableLocations

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

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

object (PlannableLocation)

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

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

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

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

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

PlannableLocation

موقع جغرافي قابل للتخطيط يُستخدَم للتوقّع

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "geoRegionType": enum (GeoRegionType),
  "plannableLocationId": string,
  "regionCode": string,
  "parentPlannableLocationId": string
}
الحقول
name

string

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

string

هذه القيمة هي للناتج فقط. الاسم المعروض للموقع الجغرافي، مثلاً "الجزائر"
geoRegionType

enum (GeoRegionType)

هذه القيمة هي للناتج فقط. نوع الموقع الجغرافي
plannableLocationId

string (int64 format)

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

string

هذه القيمة هي للناتج فقط. رمز المنطقة للموقع الجغرافي، مثلاً "DZ" للجزائر
parentPlannableLocationId

string (int64 format)

هذه القيمة هي للناتج فقط. رقم تعريف الموقع الجغرافي القابل للتخطيط الرئيسي، مثلاً رقم تعريف البلد للمناطق الجغرافية الفرعية