Method: advertisers.audit

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

HTTP 请求

GET https://displayvideo.googleapis.com/v1/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"。

请求正文

请求正文必须为空。

响应正文

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

AdvertisersService.AuditAdvertiser 的响应消息。

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

string (int64 format)

此广告客户名下的“有效”“已暂停”和“草稿”订单项的数量。这些订单项会计入每个广告客户 9999 个订单项的限制。
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 概览。