- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- PoiSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- BusinessChainSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- GeoRegionSearchTerms
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
특정 검색어를 기준으로 특정 유형의 타겟팅 옵션을 검색합니다.
HTTP 요청
POST https://displayvideo.googleapis.com/v2/targetingTypes/{targetingType}/targetingOptions:search
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
targetingType |
필수 항목입니다. 검색할 타겟팅 옵션의 유형입니다. 허용되는 값은 다음과 같습니다.
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "advertiserId": string, "pageSize": integer, "pageToken": string, // Union field |
필드 | |
---|---|
advertiserId |
필수 항목입니다. 이 요청이 이루어진 광고주입니다. |
pageSize |
요청한 페이지 크기입니다. |
pageToken |
서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이전 |
통합 필드 search_terms . 타겟팅 옵션을 검색할 때 사용하는 검색어입니다. search_terms 의 필드 1개만 작성할 수 있으며, 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 |
원하는 관심 장소의 이름, 상세 주소 또는 좌표에 대한 검색어입니다. 쿼리는 접두사일 수 있습니다. 예: 'Times squar', '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' 등 |