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.