Method: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list

列出分配给广告订单的定位选项。

HTTP 请求

GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions

网址采用 gRPC 转码语法。

路径参数

参数
advertiserId

string (int64 format)

必需。广告订单所属广告客户的 ID。

insertionOrderId

string (int64 format)

必需。要为其列出已分配定位选项的广告订单的 ID。

targetingType

enum (TargetingType)

必需。指明要列出的指定定位选项的类型。

查询参数

参数
pageSize

integer

请求的页面大小。必须介于 15000 之间。如果未指定,则默认为 100。如果指定了无效值,则返回错误代码 INVALID_ARGUMENT

pageToken

string

标识服务器应返回的结果页面的令牌。通常,这是上一次调用 assignedTargetingOptions.list 方法时返回的 nextPageToken 值。如果未指定,将返回第一页结果。

orderBy

string

列表排序所依据的字段。可接受的值为:

  • assignedTargetingOptionId(默认)

默认排序顺序是升序。要为字段指定降序,应在字段名称中添加后缀“desc”。示例:assignedTargetingOptionId desc

filter

string

允许按已分配的定位选项字段进行过滤。

支持的语法:

  • 过滤表达式由一项或多项限制组成。
  • 您可以使用逻辑运算符 OR 来组合限制。
  • 限制的形式为 {field} {operator} {value}
  • 所有字段都必须使用 EQUALS (=) 运算符。

支持的字段:

  • assignedTargetingOptionId
  • inheritance

示例:

  • ID 为 1 或 2 的 AssignedTargetingOption 资源:assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"
  • 继承状态为 NOT_INHERITEDINHERITED_FROM_PARTNERAssignedTargetingOption 资源:inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"

此字段的长度不应超过 500 个字符。

如需了解详情,请参阅我们的过滤 LIST 请求指南。

请求正文

请求正文必须为空。

响应正文

如果成功,响应正文将包含结构如下的数据:

assignedTargetingOptions.list 的响应消息。

JSON 表示法
{
  "assignedTargetingOptions": [
    {
      object (AssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
字段
assignedTargetingOptions[]

object (AssignedTargetingOption)

已分配的定位选项的列表。

如果为空,则不会显示此列表。

nextPageToken

string

标识下一页结果的令牌。此值应在后续 ListInsertionOrderAssignedTargetingOptionsRequest 中指定为 pageToken,以获取下一页结果。如果没有更多要返回的 assignedTargetingOptions,则此令牌将不存在。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/display-video

有关详情,请参阅 OAuth 2.0 概览