Method: targetingTypes.targetingOptions.search

지정된 검색어를 기반으로 지정된 유형의 타겟팅 옵션을 검색합니다.

HTTP 요청

POST https://displayvideo.googleapis.com/v1/targetingTypes/{targetingType}/targetingOptions:search

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

경로 매개변수

매개변수
targetingType

enum (TargetingType)

필수 항목입니다. 검색할 타겟팅 옵션의 유형입니다.

허용되는 값은 다음과 같습니다.

  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_POI
  • TARGETING_TYPE_BUSINESS_CHAIN

요청 본문

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

JSON 표현 
{
  "advertiserId": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field search_terms can be only one of the following:
  "poiSearchTerms": {
    object (PoiSearchTerms)
  },
  "businessChainSearchTerms": {
    object (BusinessChainSearchTerms)
  },
  "geoRegionSearchTerms": {
    object (GeoRegionSearchTerms)
  }
  // End of list of possible types for union field search_terms.
}
필드
advertiserId

string (int64 format)

필수 항목입니다. 이 요청이 이루어지는 광고주입니다.
pageSize

integer

요청한 페이지 크기입니다. 1에서 200 사이여야 합니다. 지정하지 않으면 기본값은 100입니다. 잘못된 값이 지정된 경우 오류 코드 INVALID_ARGUMENT을 반환합니다.
pageToken

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이전 targetingOptions.search 메서드 호출에서 반환된 nextPageToken 값입니다. 지정하지 않으면 결과의 첫 페이지가 표시됩니다.
통합 필드 search_terms. 타겟팅 옵션을 검색할 때 사용하는 검색어입니다. search_terms의 필드 하나만 작성할 수 있으며 targeting_type와 일치해야 합니다. search_terms는 다음 중 하나여야 합니다.
poiSearchTerms

object (PoiSearchTerms)

관심 장소 타겟팅 옵션에 대한 검색어 targetingType가 TARGETING_TYPE_POI인 경우에만 사용할 수 있습니다.
businessChainSearchTerms

object (BusinessChainSearchTerms)

비즈니스 체인 타겟팅 옵션에 대한 검색어입니다. targetingType가 TARGETING_TYPE_BUSINESS_CHAIN인 경우에만 사용할 수 있습니다.
geoRegionSearchTerms

object (GeoRegionSearchTerms)

지역 타겟팅 옵션에 대한 검색어입니다. targetingType가 TARGETING_TYPE_GEO_REGION인 경우에만 사용할 수 있습니다.

응답 본문

성공하면 응답 본문에 다음과 같은 구조의 데이터가 포함됩니다.

targetingOptions.search에 대한 응답 메시지입니다.

JSON 표현 
{
  "targetingOptions": [
    {
      object (TargetingOption)
    }
  ],
  "nextPageToken": string
}
필드
targetingOptions[]

object (TargetingOption)

검색 기준과 일치하는 타겟팅 옵션의 목록입니다.

비어 있는 경우 이 목록은 표시되지 않습니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰입니다. 이후 targetingOptions.search 메서드 호출에서 pageToken 필드에 이 값을 전달하여 결과의 다음 페이지를 검색합니다.

승인 범위

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

  • https://www.googleapis.com/auth/display-video

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

PoiSearchTerms

관심 장소 타겟팅 옵션에 대한 검색어

JSON 표현 
{
  "poiQuery": string
}
필드
poiQuery

string

원하는 관심 장소 이름, 상세 주소 또는 원하는 관심 장소의 좌표에 대한 검색어입니다. 검색어는 접두사(예: '타임스쿼', '40.7505045,-73.99562', '315 W 44th St' 등)일 수 있습니다.

BusinessChainSearchTerms

비즈니스 체인 타겟팅 옵션에 대한 검색어입니다.

필드 중 하나 이상을 입력해야 합니다.

JSON 표현 
{
  "businessChainQuery": string,
  "regionQuery": string
}
필드
businessChainQuery

string

원하는 비즈니스 체인의 검색어입니다. 쿼리는 비즈니스의 전체 이름이어야 합니다(예: 'KFC', 'mercedes-benz').
regionQuery

string

원하는 지역에 대한 검색어입니다(예: '시애틀', '미국').

GeoRegionSearchTerms

지역 타겟팅 옵션에 대한 검색어입니다.

JSON 표현 
{
  "geoRegionQuery": string
}
필드
geoRegionQuery

string

원하는 지역의 검색어입니다. 검색어는 'New Yor', 'Seattle', 'USA' 등의 접두사일 수 있습니다.