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

סוג המיקום. סוגי המיקומים תואמים לסוג היעד המוחזר על ידי חיפוש סוג המיקום ב-GoogleAdsService.Search/SearchStream.