Method: geoTargetConstants.suggest

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

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

HTTP 요청

POST https://googleads.googleapis.com/v17/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

위치 이름으로 요청을 검색한 경우 지역 타겟과 일치하는 위치 이름입니다.