- درخواست HTTP
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- مکان نام ها
- GeoTargets
- GeoTargetConstantSuggestion
- آن را امتحان کنید!
پیشنهادات 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 |
زمینه های | |
---|---|
locale | در صورت امکان، اهداف جغرافیایی برگشتی با استفاده از این منطقه ترجمه می شوند. اگر نه، en به طور پیش فرض استفاده می شود. این همچنین به عنوان یک اشاره برای اهداف جغرافیایی برگشتی استفاده می شود. |
countryCode | اهداف جغرافیایی برگردانده شده به این کد کشور محدود شده است. |
query جو فیلد اتحادیه ضروری. انتخابگر ثابت های هدف جغرافیایی. query می تواند تنها یکی از موارد زیر باشد: | |
locationNames | نام مکان برای جستجو. حداکثر 25 نام را می توان تنظیم کرد. |
geoTargets | هدف جغرافیایی نام منابع ثابت برای فیلتر کردن. |
بدن پاسخگو
پیام پاسخ برای GeoTargetConstantService.SuggestGeoTargetConstants
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"geoTargetConstantSuggestions": [
{
object ( |
زمینه های | |
---|---|
geoTargetConstantSuggestions[] | پیشنهادات ثابت جغرافیایی هدف. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
مکان نام ها
لیستی از نام مکان ها
نمایندگی JSON |
---|
{ "names": [ string ] } |
زمینه های | |
---|---|
names[] | لیستی از نام مکان ها |
GeoTargets
فهرستی از نامهای منابع ثابت هدف جغرافیایی.
نمایندگی JSON |
---|
{ "geoTargetConstants": [ string ] } |
زمینه های | |
---|---|
geoTargetConstants[] | فهرستی از نامهای منابع ثابت هدف جغرافیایی. |
GeoTargetConstantSuggestion
یک پیشنهاد ثابت جغرافیایی
نمایندگی JSON |
---|
{ "geoTargetConstant": { object ( |
زمینه های | |
---|---|
geoTargetConstant | نتیجه GeoTargetConstant. |
geoTargetConstantParents[] | لیست والدین ثابت هدف جغرافیایی. |
locale | زبانی که این GeoTargetConstantSuggestion در حال حاضر به آن ترجمه شده است. نام فیلدهای هدف جغرافیایی را تحت تأثیر قرار می دهد. برای مثال، اگر locale=en، پس name=اسپانیا. اگر locale=es، پس name=España. اگر ترجمه ای برای زبان در درخواست وجود نداشته باشد، محلی پیش فرض برگردانده می شود. |
reach | جمعیت تقریبی کاربرانی که هدف قرار خواهند گرفت، به نزدیکترین 100 گرد شده است. |
searchTerm | اگر درخواست بر اساس نام مکان جستجو شود، این نام مکانی است که با هدف جغرافیایی مطابقت دارد. |