Method: advertisers.audit

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

HTTP 请求

GET https://displayvideo.googleapis.com/v3/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)

相应广告客户下的有效、已暂停和草稿广告订单的数量。这些广告订单会计入每个广告客户 9999 个广告订单的上限。
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)

相应广告客户名下的订单项所分配的以下定位类型中的具体定位选项的数量。这些单独的定位选项计入每个广告客户 90 万个广告系列定位选项的上限。

符合条件的定位类型：

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

授权范围

需要以下 OAuth 范围：

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

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