根据指定搜索字词搜索指定类型的定位选项。
HTTP 请求
POST https://displayvideo.googleapis.com/v2/targetingTypes/{targetingType}/targetingOptions:search
网址采用 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 |
所需地图注点名称、街道地址或所需地图注点坐标的搜索查询。查询可以是前缀,例如“Times squar”“40.7505045,-73.99562”“315 W 44th St”等。 |
BusinessChainSearchTerms
连锁企业定位选项的搜索字词。
应至少填充其中一个字段。
JSON 表示法 |
---|
{ "businessChainQuery": string, "regionQuery": string } |
字段 | |
---|---|
businessChainQuery |
所需连锁企业的搜索查询。查询内容必须是完整的商家名称,例如“KFC”“梅赛德斯奔驰”。 |
regionQuery |
所需地理区域的搜索查询,例如“西雅图”“美国”。 |
GeoRegionSearchTerms
用于选择地理区域定位选项的搜索字词。
JSON 表示法 |
---|
{ "geoRegionQuery": string } |
字段 | |
---|---|
geoRegionQuery |
所需地理区域的搜索查询。查询可以是前缀,例如“New Yor”“Seattle”“USA”等。 |