Method: geoTargetConstants.suggest

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

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

בקשת HTTP

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

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

string (int64 format)

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

string

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