Method: geoTargetConstants.suggest

위치 이름 또는 리소스 이름을 기준으로 GeoTargetConstant 추천을 반환합니다.

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

HTTP 요청

POST https://googleads.googleapis.com/v14/geoTargetConstants:suggest

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "locale": string,
  "countryCode": string,

  // Union field query can be only one of the following:
  "locationNames": {
    object (LocationNames)
  },
  "geoTargets": {
    object (GeoTargets)
  }
  // End of list of possible types for union field query.
}
필드
locale

string

가능한 경우 반환된 지역 타겟은 이 언어를 사용하여 번역됩니다. 지정하지 않으면 기본적으로 en이 사용됩니다. 이는 반환된 지역 타겟에 대한 힌트로도 사용됩니다.
countryCode

string

반환되는 지역 타겟은 이 국가 코드로 제한됩니다.
통합 필드 query. 필수 항목입니다. 지역 타겟 상수의 셀렉터입니다. query은 다음 중 하나여야 합니다.
locationNames

object (LocationNames)

검색할 위치 이름입니다. 최대 25개의 이름을 설정할 수 있습니다.
geoTargets

object (GeoTargets)

필터링할 지역 타겟 상수 리소스 이름입니다.

응답 본문

GeoTargetConstantService.SuggestGeoTargetConstants의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
필드
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

지역 타겟팅 상수 추천입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

LocationNames

위치 이름 목록입니다.

JSON 표현 
{
  "names": [
    string
  ]
}
필드
names[]

string

위치 이름 목록입니다.

GeoTargets

지역 타겟 상수 리소스 이름의 목록입니다.

JSON 표현 
{
  "geoTargetConstants": [
    string
  ]
}
필드
geoTargetConstants[]

string

지역 타겟 상수 리소스 이름의 목록입니다.

GeoTargetConstantSuggestion

지역 타겟 상수 추천입니다.

JSON 표현 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
필드
geoTargetConstant

object (GeoTargetConstant)

GeoTargetConstant 결과입니다.
geoTargetConstantParents[]

object (GeoTargetConstant)

지역 타겟 상수의 상위 목록입니다.
locale

string

이 GeoTargetConstantSuggestion이 현재 번역되어 있는 언어입니다. 지역 타겟 필드의 이름에 영향을 미칩니다. 예를 들어 locale=en인 경우 name=Spain입니다. locale=es인 경우 name=España로 표기합니다. 요청에 언어에 대한 번역이 없으면 기본 언어가 반환됩니다.
reach

string (int64 format)

타겟팅되는 대략적인 사용자 인구이며 100명 단위로 반올림됩니다.
searchTerm

string

위치 이름으로 요청이 검색되면 지역 타겟과 일치하는 위치 이름입니다.