Method: listPlannableLocations

傳回可計畫的地點清單 (例如國家/地區)。

擲回錯誤清單：AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體必須為空白。

回應主體

可規劃的地點清單。

如果成功，回應主體即會包含具有以下結構的資料：

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

地區 ID。
name

string

以英文撰寫的專屬地區名稱。
parentCountryId

string (int64 format)

母國家/地區 (如果地點為國家/地區則不會顯示)。如有，則一律為 GeoTargetConstant ID。國家/地區名稱等額外資訊是由 ReachPlanService.ListPlannableLocations 或 GoogleAdsService.Search/SearchStream 提供。
countryCode

string

與該位置相關聯的 ISO-3166-1 alpha-2 國家/地區代碼。
locationType

string

地區類型。位置類型與在 GoogleAdsService.Search/SearchStream 中搜尋位置類型所傳回的 targetType 相對應。