列出为多个广告组分配的定位选项(适用于各种定位类型)。
不包含继承的已分配定位选项。
HTTP 请求
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups:bulkListAdGroupAssignedTargetingOptions
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
advertiserId |
必需。订单项所属广告客户的 ID。 |
查询参数
参数 | |
---|---|
adGroupIds[] |
必需。要为其列出已分配定位选项的广告组的 ID。 |
pageSize |
可选。请求的页面大小。大小必须是 |
pageToken |
可选。可让客户端获取下一页结果的令牌。通常,这是上一次调用 |
orderBy |
可选。列表排序所依据的字段。可接受的值为:
默认排序顺序是升序。要为字段指定降序,应在字段名称中添加后缀“desc”。示例: |
filter |
可选。允许按已分配的定位选项字段进行过滤。 支持的语法:
支持的字段:
示例:
此字段的长度不应超过 500 个字符。 如需了解详情,请参阅我们的过滤 |
请求正文
请求正文必须为空。
响应正文
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"adGroupAssignedTargetingOptions": [
{
object ( |
字段 | |
---|---|
adGroupAssignedTargetingOptions[] |
封装容器对象的列表,其中每个对象都提供指定的定位选项和所分配到的广告组。 如果为空,则不会显示此列表。 |
nextPageToken |
标识下一页结果的令牌。在后续调用 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/display-video
有关详情,请参阅 OAuth 2.0 概览。
AdGroupAssignedTargetingOption
将 AssignedTargetingOption
资源与其所分配到的广告组相关联的封装容器对象。
JSON 表示法 |
---|
{
"adGroupId": string,
"assignedTargetingOption": {
object ( |
字段 | |
---|---|
adGroupId |
所分配的定位选项所分配到的广告组的 ID。 |
assignedTargetingOption |
已分配的定位选项资源。 |