فهرست مکان های قابل برنامه ریزی (به عنوان مثال، کشورها) را برمی گرداند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QuotaError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v17:listPlannableLocations
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
لیست مکان های قابل برنامه ریزی
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"plannableLocations": [
{
object ( |
فیلدها | |
---|---|
plannableLocations[] | لیست مکان های موجود برای برنامه ریزی برای دیدن مکانهای نمونه به 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 | شناسه مکان |
name | نام مکان منحصر به فرد در انگلیسی. |
parentCountryId | کشور مادر (اگر مکان یک کشور باشد، وجود ندارد). در صورت وجود، همیشه یک شناسه GeoTargetConstant خواهد بود. اطلاعات اضافی مانند نام کشور توسط |
countryCode | کد کشور ISO-3166-1 آلفا-2 که با مکان مرتبط است. |
locationType | نوع مکان انواع مکان مطابق با targetType است که با جستجوی نوع مکان در GoogleAdsService.Search/SearchStream بازگردانده شده است. |