Method: listPlannableLocations

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

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

طلب HTTP

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