Method: geoTargetConstants.suggest

מחזירה הצעות GeoTargetConstant לפי שם מיקום או לפי שם המשאב.

רשימה של שגיאות הטמעה: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v14/geoTargetConstants:suggest

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "locale": string,
  "countryCode": string,

  // Union field query can be only one of the following:
  "locationNames": {
    object (LocationNames)
  },
  "geoTargets": {
    object (GeoTargets)
  }
  // End of list of possible types for union field query.
}
שדות
locale

string

במידת האפשר, יעדים גיאוגרפיים מוחזרים מתורגמים באמצעות המיקום הזה. אם לא, ברירת המחדל היא en. הנתון הזה משמש גם כרמז לגבי יעדים גיאוגרפיים שהוחזרו.
countryCode

string

טירגוטים גיאוגרפיים שהוחזרו מוגבלים לקוד המדינה הזו.
שדה איחוד query. חובה. בורר קבוע של טירגוט גיאוגרפי. הערך של query יכול להיות רק אחת מהאפשרויות הבאות:
locationNames

object (LocationNames)

שמות המיקומים שלפיהם צריך לחפש. ניתן להגדיר עד 25 שמות.
geoTargets

object (GeoTargets)

שמות המשאבים הקבועים של הטירגוט הגיאוגרפי שלפיהם יתבצע סינון.

גוף התגובה

הודעת תשובה לגבי GeoTargetConstantService.SuggestGeoTargetConstants.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
שדות
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

הצעות קבועות למיקוד גיאוגרפי.

היקפי הרשאות

נדרש היקף OAuth הבא:

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

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

LocationNames

רשימה של שמות המיקומים.

ייצוג JSON 
{
  "names": [
    string
  ]
}
שדות
names[]

string

רשימה של שמות המיקומים.

GeoTargets

רשימת שמות של משאבים קבועים למיקוד לפי מיקום גיאוגרפי.

ייצוג JSON 
{
  "geoTargetConstants": [
    string
  ]
}
שדות
geoTargetConstants[]

string

רשימת שמות של משאבים קבועים למיקוד לפי מיקום גיאוגרפי.

GeoTargetConstantSuggestion

הצעה קבועה של מיקוד גיאוגרפי.

ייצוג JSON 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
שדות
geoTargetConstant

object (GeoTargetConstant)

התוצאה GeoTargetConstant.
geoTargetConstantParents[]

object (GeoTargetConstant)

רשימת ההורה של קבוע המיקוד הגיאוגרפי.
locale

string

השפה שאליה מתורגם בשלב זה GeoTargetConstantSuggestion. ההגדרה משפיעה על השמות של שדות טירגוט גיאוגרפי. לדוגמה, אם locale=en, אז name=ספרד. אם locale=es, אז name=España. אם לא קיים תרגום ללוקאל שציינת בבקשה, הלוקאל שמוגדר כברירת המחדל יוחזר.
reach

string (int64 format)

אוכלוסיית המשתמשים המשוערת שיהיה מטורגט, מעוגל ל-100 האוכלוסייה הקרובה ביותר.
searchTerm

string

אם בוצע חיפוש בבקשה לפי שם המיקום, זהו שם המיקום שתאם ליעד הגיאוגרפי.