تعرض قائمة المواقع الجغرافية القابلة للتخطيط (على سبيل المثال، البلدان).
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v15:listPlannableLocations
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة المواقع الجغرافية القابلة للتخطيط.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"plannableLocations": [
{
object ( |
الحقول | |
---|---|
plannableLocations[] |
قائمة المواقع الجغرافية المتاحة للتخطيط. يمكنك الانتقال إلى 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 |
معرّف الموقع الجغرافي. |
name |
اسم الموقع الجغرافي الفريد باللغة الإنجليزية. |
parentCountryId |
البلد الرئيسي (غير موجود إذا كان الموقع الجغرافي بلدًا). في حال توفّره، سيكون دائمًا رقم تعريف GeoTargetConstant. يتم توفير معلومات إضافية، مثل اسم البلد من خلال |
countryCode |
رمز البلد المرتبط بالموقع الجغرافي وفقًا لمعيار ISO-3166-1 alpha-2. |
locationType |
نوع الموقع الجغرافي تتوافق أنواع المواقع مع targetType الذي يتم عرضه من خلال البحث في نوع الموقع في GoogleAdsService.Search/SearchStream. |