Curation Partners API

精选合作伙伴 API 是一种对外提供的 HTTP API,供精选方以程序化方式管理其数据细分和广告代理机构使用的精选包。

服务:curationpartners.googleapis.com

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

发现文档

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

服务端点

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

  • https://curationpartners.googleapis.com

REST 资源:v1.curators.curatedPackages

方法
activate POST /v1/{name=curators/*/curatedPackages/*}:activate
激活现有精选资源包。
create POST /v1/{parent=curators/*}/curatedPackages
创建新的甄选资源包。
deactivate POST /v1/{name=curators/*/curatedPackages/*}:deactivate
停用现有精选资源包。
get GET /v1/{name=curators/*/curatedPackages/*}
获取指定资源名称的甄选广告资源包。
list GET /v1/{parent=curators/*}/curatedPackages
列出由指定精选者拥有的精选软件包。
patch PATCH /v1/{curatedPackage.name=curators/*/curatedPackages/*}
更新现有精选软件包。

REST 资源:v1.curators.dataSegments

方法
activate POST /v1/{name=curators/*/dataSegments/*}:activate
激活基于数据的细分受众群。
create POST /v1/{parent=curators/*}/dataSegments
创建由所列精选者拥有的基于数据的细分受众群。
deactivate POST /v1/{name=curators/*/dataSegments/*}:deactivate
停用基于数据的细分受众群。
get GET /v1/{name=curators/*/dataSegments/*}
获取指定名称的数据片段。
list GET /v1/{parent=curators/*}/dataSegments
列出甄选方拥有的基于数据的细分受众群。
patch PATCH /v1/{dataSegment.name=curators/*/dataSegments/*}
更新基于数据的细分受众群。

REST 资源:v1.curators.reports

方法
create POST /v1/{parent=curators/*}/reports
创建 Report 对象。
delete DELETE /v1/{name=curators/*/reports/*}
删除 Report 对象。
get GET /v1/{name=curators/*/reports/*}
检索 Report 对象。
list GET /v1/{parent=curators/*}/reports
列出 Report 对象。
patch PATCH /v1/{report.name=curators/*/reports/*}
更新 Report 对象。
run POST /v1/{name=curators/*/reports/*}:run
异步启动现有报告的执行。

REST 资源:v1.curators.reports.operations

方法
get GET /v1/{name=curators/*/reports/*/operations/*}
获取长时间运行的操作的最新状态。

REST 资源:v1.curators.reports.results

方法
fetchRows GET /v1/{name=curators/*/reports/*/results/*}:fetchRows
返回已完成报告的结果行。

REST 资源:v1.mediaPlanners

方法
list GET /v1/mediaPlanners
列出调用方有权访问的所有媒体策划师账号。
search GET /v1/mediaPlanners:search
搜索与给定 DSP 账号 ID 匹配的媒体策划师账号。