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"

请求正文

请求正文必须为空。

响应正文

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

AdvertiserService.AuditAdvertiser 的响应消息。

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

string (int64 format)

此广告客户名下的 ACTIVE、PAUSED 和 DRAFT 订单项的数量。这些订单项会占用每个广告客户名下 9999 个订单项的限制。

usedInsertionOrdersCount

string (int64 format)

此广告客户名下的 ACTIVE、PAUSED 和 DRAFT 广告订单的数量。这些广告订单会计入每个广告客户 9999 个广告订单的限制。

usedCampaignsCount

string (int64 format)

此广告客户名下的 ACTIVE 和 PAUSED 广告系列的数量。在计算这些广告系列时,每个广告客户只能投放 9999 个广告系列。

channelsCount

string (int64 format)

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

negativelyTargetedChannelsCount

string (int64 format)

在此广告客户下创建的排除性定位渠道的数量。这些排除性定位渠道会计入每个广告客户只能有 5 个排除性定位渠道的限制。

negativeKeywordListsCount

string (int64 format)

在此广告客户名下创建的否定关键字列表的数量。每个广告客户最多只能创建 20 个否定关键字列表。

adGroupCriteriaCount

string (int64 format)

为此广告客户下的某个订单项分配的下列定位类型中的各个定位选项的数量。这些单独的定位选项会计入每个广告客户 4500,000 个广告组定位选项的限制。

符合条件的定位类型:

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

string (int64 format)

为此广告客户下的某个订单项分配的下列定位类型中的各个定位选项的数量。这些单独的定位选项会计入每个广告客户 900,000 个广告系列定位选项的限制。

符合条件的定位类型:

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

授权范围

需要以下 OAuth 作用域:

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

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