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)

此广告客户名下有效广告系列和暂停广告系列的数量。这些广告系列会计入每个广告客户的广告系列数量上限（9999 个）。
channelsCount

string (int64 format)

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

string (int64 format)

在此广告客户名下创建的排除性定位渠道的数量。这些定位到否定频道的广告会计入每个广告客户可定位到 5 个否定频道的限制。
negativeKeywordListsCount

string (int64 format)

在此广告客户名下创建的否定关键字列表的数量。这些否定关键字列表会计入每个广告客户的否定关键字列表数量上限（20 个）。
adGroupCriteriaCount

string (int64 format)

为此广告客户名下订单项分配的以下定位类型的具体定位选项数量。这些单个定位选项均计入每个广告客户 4500000 个广告组定位选项的数量上限。

甄别定位类型：

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

string (int64 format)

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

符合条件的定位类型：

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

授权范围

需要以下 OAuth 范围：

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

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