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
搜尋與指定需求端平台帳戶 ID 相符的媒體企劃書帳戶。