지정된 검색어를 기반으로 지정된 유형의 타겟팅 옵션을 검색합니다.
HTTP 요청
POST https://displayvideo.googleapis.com/v3/targetingTypes/{targetingType}/targetingOptions:search
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
targetingType |
필수 항목입니다. 검색할 타겟팅 옵션의 유형입니다. 허용되는 값은 다음과 같습니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
필드 | |
---|---|
advertiserId |
필수 항목입니다. 이 요청이 이루어지는 광고주입니다. |
pageSize |
요청한 페이지 크기입니다. |
pageToken |
서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이전 |
통합 필드 search_terms . 타겟팅 옵션을 검색할 때 사용하는 검색어입니다. search_terms 의 필드 하나만 작성할 수 있으며 targeting_type 와 일치해야 합니다. search_terms 는 다음 중 하나여야 합니다. |
|
poiSearchTerms |
관심 장소 타겟팅 옵션에 대한 검색어 |
businessChainSearchTerms |
비즈니스 체인 타겟팅 옵션에 대한 검색어입니다. |
geoRegionSearchTerms |
지역 타겟팅 옵션에 대한 검색어입니다. |
응답 본문
targetingOptions.search
의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"targetingOptions": [
{
object ( |
필드 | |
---|---|
targetingOptions[] |
검색 기준과 일치하는 타겟팅 옵션의 목록입니다. 비어 있는 경우 이 목록은 표시되지 않습니다. |
nextPageToken |
결과의 다음 페이지를 검색하는 토큰입니다. 이후 |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/display-video
자세한 내용은 OAuth 2.0 개요를 참고하세요.
PoiSearchTerms
관심 장소 타겟팅 옵션에 대한 검색어
JSON 표현 |
---|
{ "poiQuery": string } |
필드 | |
---|---|
poiQuery |
원하는 관심 장소 이름, 상세 주소 또는 원하는 관심 장소의 좌표에 대한 검색어입니다. 검색어는 접두사(예: '타임스쿼', '40.7505045,-73.99562', '315 W 44th St' 등)일 수 있습니다. |
BusinessChainSearchTerms
비즈니스 체인 타겟팅 옵션에 대한 검색어입니다.
필드 중 하나 이상을 입력해야 합니다.
JSON 표현 |
---|
{ "businessChainQuery": string, "regionQuery": string } |
필드 | |
---|---|
businessChainQuery |
원하는 비즈니스 체인의 검색어입니다. 쿼리는 비즈니스의 전체 이름이어야 합니다(예: 'KFC', 'mercedes-benz'). |
regionQuery |
원하는 지역에 대한 검색어입니다(예: '시애틀', '미국'). |
GeoRegionSearchTerms
지역 타겟팅 옵션에 대한 검색어입니다.
JSON 표현 |
---|
{ "geoRegionQuery": string } |
필드 | |
---|---|
geoRegionQuery |
원하는 지역의 검색어입니다. 검색어는 'New Yor', 'Seattle', 'USA' 등의 접두사일 수 있습니다. |