Curation Partners API

キュレーション パートナー API は、キュレーターが広告代理店で使用するデータ セグメントとキュレーション パッケージをプログラムで管理するための外部で利用可能な HTTP API です。

サービス: curationpartners.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストの際に次の情報を使用してください。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械で読み取り可能仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスには、次のディスカバリ ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することもあります。このサービスには次のサービス エンドポイントがあり、以下のすべての 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
呼び出し元がアクセスできるすべてのメディア プランナー アカウントを一覧表示します。