精选合作伙伴 API 是一种对外提供的 HTTP API,供精选方以程序化方式管理其数据细分和广告代理机构使用的精选包。
- REST 资源:v1.curators.curatedPackages
- REST 资源:v1.curators.dataSegments
- REST 资源:v1.curators.reports
- REST 资源:v1.curators.reports.operations
- REST 资源:v1.curators.reports.results
- REST 资源:v1.mediaPlanners
服务: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 匹配的媒体策划师账号。 |