Method: listPlannableLocations

تعرض قائمة المواقع الجغرافية القابلة للتخطيط (على سبيل المثال، البلدان).

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

طلب HTTP

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

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

نص الطلب

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

نص الاستجابة

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

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

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

object (PlannableLocation)

قائمة المواقع الجغرافية المتاحة للتخطيط. يمكنك الانتقال إلى https://developers.google.com/google-ads/api/reference/data/geotargets للاطّلاع على نماذج للمواقع.

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

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

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

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

PlannableLocation

الموقع الجغرافي القابل للتخطيط: البلد، أو المنطقة المركزية، أو المقاطعة، إلخ.

تمثيل JSON 
{
  "id": string,
  "name": string,
  "parentCountryId": string,
  "countryCode": string,
  "locationType": string
}
الحقول
id

string

معرّف الموقع الجغرافي
name

string

اسم الموقع الفريد باللغة الإنجليزية.
parentCountryId

string (int64 format)

البلد الأم (غير موجود إذا كان الموقع الجغرافي بلدًا). في حال توفّره، سيكون رقم تعريف GeoTargetConstant دائمًا. يتم تقديم معلومات إضافية، مثل اسم البلد، من خلال ReachPlanService.ListPlannableLocations أو GoogleAdsService.Search/SearchStream.
countryCode

string

تمثّل هذه السمة رمز البلد وفقًا لمعيار ISO-3166-1 alpha-2 المرتبط بالموقع الجغرافي.
locationType

string

نوع الموقع الجغرافي تتوافق أنواع المواقع الجغرافية مع targetType الذي يتم عرضه من خلال البحث عن نوع الموقع في GoogleAdsService.Search/SearchStream.