用于执行广告数据中心查询的 API。
- REST 资源:v1.customers
- REST 资源:v1.customers.adsDataCustomers
- REST 资源:v1.customers.adsDataLinks
- REST 资源:v1.customers.analyzeQuery
- REST 资源:v1.customers.customBiddingAlgorithms
- REST 资源:v1.customers.inboundCustomerLinks
- REST 资源:v1.customers.outboundCustomerLinks
- REST 资源:v1.customers.tables
- REST 资源:v1.customers.tempTables
- REST 资源:v1.customers.userListQuery
- REST 资源:v1.customers.userLists
- REST 资源:v1.operations
- REST 资源:v1.outage
服务: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.adsDataLinks
方法 | |
---|---|
batchApprove |
POST /v1/{parent=customers/*}/adsDataLinks:batchApprove 批准待处理的广告数据关联列表。 |
batchReject |
POST /v1/{parent=customers/*}/adsDataLinks:batchReject 拒绝待处理的广告数据关联列表。 |
list |
GET /v1/{parent=customers/*}/adsDataLinks 列出指定客户与其他 Google 广告实体之间的关联。 |
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.inboundCustomerLinks
方法 | |
---|---|
list |
GET /v1/{parent=customers/*}/inboundCustomerLinks 列出其他广告数据中心客户已向指定客户授予访问权限的链接。 |
REST 资源:v1.customers.outboundCustomerLinks
方法 | |
---|---|
list |
GET /v1/{parent=customers/*}/outboundCustomerLinks 列出指定客户已授权访问其他广告数据中心客户的链接。 |
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 |
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 天。 |