Method: advertisers.audit

审核广告客户。返回所提供广告客户名下每种资源类型的已用实体数量。已使用的实体会计入其各自的资源限制。请参阅 https://support.google.com/displayvideo/answer/6071450。

HTTP 请求

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}:audit

网址采用 gRPC 转码语法。

路径参数

参数
advertiserId

string (int64 format)

必需。要审核的广告客户的 ID。

查询参数

参数
readMask

string (FieldMask format)

可选。要返回的特定字段。如果未指定掩码，则响应 proto 中的所有字段都将被填充。有效值包括：

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。

请求正文

请求正文必须为空。

响应正文

AdvertiserService.AuditAdvertiser 的响应消息。

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

JSON 表示法 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
字段
usedLineItemsCount

string (int64 format)

此广告客户名下处于“有效”“已暂停”和“草稿”状态的订单项数量。这些订单项会计入每个广告客户 9,999 个订单项的上限。
usedInsertionOrdersCount

string (int64 format)

此广告客户名下处于“有效”“已暂停”和“草稿”状态的广告订单数量。这些广告订单会计入每个广告客户 9,999 个广告订单的上限。
usedCampaignsCount

string (int64 format)

此广告客户名下处于“有效”和“已暂停”状态的广告系列数量。这些广告系列会计入每个广告客户 9,999 个广告系列的上限。
channelsCount

string (int64 format)

在此广告客户下创建的渠道数量。这些频道会计入每个广告客户 1,000 个频道的上限。
negativelyTargetedChannelsCount

string (int64 format)

在此广告客户下创建的排除性定位频道的数量。这些排除性定位的频道会计入每个广告客户最多可排除性定位 5 个频道的上限。
negativeKeywordListsCount

string (int64 format)

在此广告客户下创建的否定关键字列表数量。这些否定关键字列表会计入每个广告客户最多只能创建 20 个否定关键字列表的限制。
adGroupCriteriaCount

string (int64 format)

此广告客户名下的订单项所分配到的以下定位类型的具体定位选项数量。这些单独的定位选项会计入每个广告客户 450 万个广告组定位选项的上限。

符合条件的定位类型：

  • 渠道、网址、应用和集合
  • 受众特征
  • Google 受众群体，包括兴趣相似的受众群体、自定义的兴趣相似细分受众群和有购买意向的受众群体
  • 广告资源来源
  • 关键字
  • 移动应用类别
  • 用户名单
  • 视频定位
  • 可见度
campaignCriteriaCount

string (int64 format)

此广告客户名下的订单项所分配到的以下定位类型的具体定位选项数量。这些单独的定位选项会计入每个广告客户 900,000 个广告系列定位选项的上限。

符合条件的定位类型：

  • 位置
  • 浏览器
  • 连接速度
  • 周几和时段
  • 设备和操作系统
  • 数字内容标签
  • 敏感类别
  • 环境
  • 地理位置，包括连锁企业和邻近性
  • ISP
  • 语言
  • 第三方验证

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 Overview。