Method: geoTargetConstants.suggest

پیشنهادات GeoTargetConstant را بر اساس نام مکان یا نام منبع برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError داخلیError QuotaError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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 مراجعه کنید.

مکان نام ها

لیستی از نام مکان ها

نمایندگی 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

اگر درخواست بر اساس نام مکان جستجو شود، این نام مکانی است که با هدف جغرافیایی مطابقت دارد.