Method: listPlannableLocations

계획 가능한 위치의 목록을 반환합니다 (예: 국가).

발생한 오류 목록: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError

HTTP 요청

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

URL은 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

위치 식별자입니다.
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과 일치합니다.