Ads Data Hub API

用于执行广告数据中心查询的 API。

服务:adsdatahub.googleapis.com

如需调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,请在发出 API 请求时使用以下信息。

发现文档

发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:

服务端点

服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:

  • https://adsdatahub.googleapis.com

REST 资源:v1.customers

方法
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
描述有效的 DV360 广告客户 ID
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
列出有效的事件匹配器及其元数据,用于为受众群体名单设置频次上限。
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
将客户帐号的作业历史记录导出到客户选择的 BigQuery 数据集。
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
开始执行查询,以检索 DV360 平台的无效流量可见度指标。
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
开始执行查询,以检索特定平台的无效流量每天数据摘要。
get GET /v1/{name=customers/*}
检索请求的广告数据中心客户。
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
返回在指定日期成功提取到广告数据中心的所有客户的 Google 数据所占的百分比。
list GET /v1/customers
列出当前用户有权访问的广告数据中心客户。

REST 资源:v1.customers.adsDataCustomers

方法
get GET /v1/{name=customers/*/adsDataCustomers/*}
检索请求的广告数据中心客户。
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
检索所请求广告数据源过去 366 天的数据访问预算。
list GET /v1/{parent=customers/*}/adsDataCustomers
列出客户可以访问的广告数据。

REST 资源:v1.customers.analyticsQuery

方法
create POST /v1/{parent=customers/*}/analysisQueries
创建分析查询以备稍后执行。
delete DELETE /v1/{name=customers/*/analysisQueries/*}
删除分析查询。
get GET /v1/{name=customers/*/analysisQueries/*}
检索请求的分析查询。
list GET /v1/{parent=customers/*}/analysisQueries
列出指定客户所拥有的分析查询。
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
更新现有分析查询。
start POST /v1/{name=customers/*/analysisQueries/*}:start
开始对存储的分析查询执行。
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
开始执行瞬时分析查询。
validate POST /v1/{parent=customers/*}/analysisQueries:validate
对提供的分析查询执行静态验证检查。

REST 资源:v1.customers.customBiddingAlgorithms

方法
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
将 DV360 广告客户添加到自定义出价算法的广告客户中。
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
创建由广告数据中心管理的自定义出价算法。
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
删除此自定义出价算法。
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
为自定义出价模型统计过去 30 天的展示次数。
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
检索请求的广告数据中心管理的自定义出价算法。
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
列出由指定广告数据中心客户管理的自定义出价算法。
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
更新所请求的由广告数据中心管理的自定义出价算法。
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
从自定义出价算法的广告客户中移除 DV360 广告客户。

REST 资源:v1.customers.tables

方法
get GET /v1/{name=customers/*/tables/*}
检索请求的广告数据中心表。
list GET /v1/{parent=customers/*}/tables
列出指定客户有权访问的广告数据中心表。

REST 资源:v1.customers.tempTables

方法
get GET /v1/{name=customers/*/tempTables/*}
检索请求的广告数据中心临时表。
list GET /v1/{parent=customers/*}/tempTables
列出客户创建的广告数据中心临时表。

REST 资源:v1.customers.userListQuery

方法
create POST /v1/{parent=customers/*}/userListQueries
创建用户列表查询,以便稍后执行。
delete DELETE /v1/{name=customers/*/userListQueries/*}
删除用户列表查询。
get GET /v1/{name=customers/*/userListQueries/*}
检索所请求的用户列表查询。
list GET /v1/{parent=customers/*}/userListQueries
列出指定客户拥有的用户列表查询。
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
更新现有用户列表查询。
start POST /v1/{name=customers/*/userListQueries/*}:start
开始对已存储的用户名单查询执行命令。
startTransient
(deprecated)
POST /v1/{parent=customers/*}/userListQueries:startTransient
开始执行临时用户列表查询。
validate POST /v1/{parent=customers/*}/userListQueries:validate
对提供的用户列表查询执行静态验证检查。

REST 资源:v1.customers.userLists

方法
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
将事件匹配器添加到基于频率的用户列表中。
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
将实体添加到广告数据中心管理的用户名单收件人中。
create POST /v1/{parent=customers/*}/userLists
创建由广告数据中心管理的用户名单。
delete DELETE /v1/{name=customers/*/userLists/*}
删除所请求的由广告数据中心管理的用户名单。
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
为 UserList 生成成员资格。
get GET /v1/{name=customers/*/userLists/*}
检索请求的广告数据中心管理的用户名单。
list GET /v1/{parent=customers/*}/userLists
列出由指定广告数据中心客户管理的用户名单。
patch PATCH /v1/{userList.name=customers/*/userLists/*}
更新所请求的由广告数据中心管理的用户名单。
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
从广告数据中心管理的用户名单收件人中移除实体。

REST 资源:v1.operations

方法
cancel POST /v1/{name=operations/**}:cancel
对长时间运行的操作启动异步取消。
delete DELETE /v1/{name=operations/**}
删除长时间运行的操作。
get GET /v1/{name=operations/**}
获取长时间运行的操作的最新状态。
list GET /v1/{name}
列出与请求中指定的过滤条件匹配的操作。
wait POST /v1/{name=operations/**}:wait
等待指定的长时间运行的操作完成或最多达到指定的超时时间,返回最新状态。

REST 资源:v1.outage

方法
list GET /v1/outages
按中断开始时间戳的降序列出中断情况,回溯期为 130 天。