- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- PoiSearchУсловия
- БизнесСетьПоискУсловия
- ГеоРегионПоискУсловия
- Попробуйте!
Ищет параметры таргетинга заданного типа на основе заданных поисковых запросов.
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 | Условия поиска для параметров таргетинга на POI. Можно использовать только в том случае, если |
businessChainSearchTerms | Условия поиска для вариантов таргетинга на бизнес-цепочку. Можно использовать только в том случае, если |
geoRegionSearchTerms | Условия поиска для параметров таргетинга на географический регион. Можно использовать только в том случае, если |
Тело ответа
Ответное сообщение для targetingOptions.search
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"targetingOptions": [
{
object ( |
Поля | |
---|---|
targetingOptions[] | Список параметров таргетинга, соответствующих критериям поиска. Этот список будет отсутствовать, если он пуст. |
nextPageToken | Токен для получения следующей страницы результатов. Передайте это значение в поле |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/display-video
Дополнительную информацию см. в обзоре OAuth 2.0 .
PoiSearchУсловия
Условия поиска для параметров таргетинга на POI.
JSON-представление |
---|
{ "poiQuery": string } |
Поля | |
---|---|
poiQuery | Поисковый запрос по названию нужного POI, почтовому адресу или координатам нужного POI. Запрос может иметь префикс, например «Таймс-сквер», «40.7505045,-73.99562», «315 W 44th St» и т. д. |
БизнесСетьПоискУсловия
Условия поиска для вариантов таргетинга на бизнес-цепочку.
Хотя бы одно поле должно быть заполнено.
JSON-представление |
---|
{ "businessChainQuery": string, "regionQuery": string } |
Поля | |
---|---|
businessChainQuery | Поисковый запрос по нужной бизнес-цепочке. В запросе должно быть полное название компании, например «KFC», «mercedes-Benz». |
regionQuery | Поисковый запрос для нужного географического региона, например «Сиэтл», «США». |
ГеоРегионПоискУсловия
Условия поиска для параметров таргетинга на географический регион.
JSON-представление |
---|
{ "geoRegionQuery": string } |
Поля | |
---|---|
geoRegionQuery | Поисковый запрос для нужного георегиона. Запрос может иметь префикс, например «Нью-Йорк», «Сиэтл», «США» и т. д. |