Method: listPlannableLocations

فهرست مکان های قابل برنامه ریزی (به عنوان مثال، کشورها) را برمی گرداند.

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

درخواست HTTP

POST https://googleads.googleapis.com/v14:listPlannableLocations

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

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

لیست مکان های قابل برنامه ریزی

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "plannableLocations": [
    {
      object (PlannableLocation)
    }
  ]
}
زمینه های
plannableLocations[]

object ( PlannableLocation )

لیست مکان های موجود برای برنامه ریزی برای دیدن مکان‌های نمونه به https://developers.google.com/google-ads/api/reference/data/geotargets مراجعه کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

PlannableLocation

مکان قابل برنامه ریزی: کشور، منطقه مترو، استان و غیره.

نمایندگی JSON
{
  "id": string,
  "name": string,
  "parentCountryId": string,
  "countryCode": string,
  "locationType": string
}
زمینه های
id

string

شناسه مکان

name

string

نام مکان منحصر به فرد در انگلیسی.

parentCountryId

string ( int64 format)

کشور مادر (اگر مکان یک کشور باشد، وجود ندارد). در صورت وجود، همیشه یک شناسه GeoTargetConstant خواهد بود. اطلاعات اضافی مانند نام کشور توسط ReachPlanService.ListPlannableLocations یا GoogleAdsService.Search/SearchStream ارائه می شود.

countryCode

string

کد کشور ISO-3166-1 آلفا-2 که با مکان مرتبط است.

locationType

string

نوع مکان انواع مکان مطابق با targetType است که با جستجوی نوع مکان در GoogleAdsService.Search/SearchStream بازگردانده شده است.