Method: geoTargetConstants.suggest

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

רשימת שגיאות שקרו: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

בקשת HTTP

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

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