Method: geoTargetConstants.suggest

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

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

HTTP 요청

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

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