Curation Partners API を使用してデータセグメントを作成、管理できます。この API は
リソースcurators.dataSegmentsを公開します。これは、統合に使用できる生成されたクライアント
ライブラリを備えた REST API です。
認証を設定する
Google API では、認証 および承認に OAuth 2.0 プロトコルを使用しています。Curation Partners API にアクセスするためのサービス アカウントを設定する方法は次のとおりです。
まだ作成していない場合は、API へのアクセスに使用する認証情報をホストする Google Cloud プロジェクト を作成します。
[Google Cloud コンソールの有効な API] ページに移動します。先ほど作成したプロジェクトを選択します。
有効な API とサービスのリストを確認します。Curation Partners API にアクセスするには、この API を有効にする必要があります。Curation Partners API が有効になっていない場合は、[+API とサービスの有効化] をクリックして、次の手順を行います。
- 検索ボックスを使用して「Curation Partners API 」を検索します。
- 検索結果ページで [Curation Partners API] を選択します。
- [有効にする] をクリックします。
Google Cloud コンソールの検索ボックスで Curation Partners API を見つけられないという既知の問題があります。代わりに、 Google Cloud CLI を使用して API を有効にできます。gcloud CLI をインストールしたら、次のコマンドで Curation Partners API を有効にできます。
gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_IDナビゲーション メニューで [認証情報] を選択します。
[+認証情報を作成] をクリックし、表示されたプルダウン メニューで [サービス アカウント] を選択します。
サービス アカウントの名前 を入力します。サービス アカウント ID は作成時に自動的に作成されます。この値は後のステップ 14 で必要になるため、メモしておいてください。必要に応じて、説明を入力します。[作成して続行] をクリックします。
必要に応じて、サービス アカウントの権限を構成し、[続行] をクリックします。
必要に応じて、サービス アカウントとしてアクションを実行できるユーザーまたはグループを構成し、[完了] をクリックします。
新しいサービス アカウントが [サービス アカウント] に表示されます。作成したサービス アカウント ID を見つけてクリックします。
[キー] タブをクリックします。
[キーを追加] プルダウン メニューで、[新しいキーを作成] を選択します。
[JSON] を [キーのタイプ] として選択し、[作成] をクリックします。
キーを作業ディレクトリにダウンロードします。キーを安全に保管する方法については、サービス アカウント キーの管理をご覧ください。 キーは、アプリケーションが API 呼び出しを行うために使用されます。
サービス アカウント ID をテクニカル アカウント マネージャーと共有して、サービス アカウントをアカウントにリンクします。
API スコープ
OAuth 2.0 フローの手順に沿って API 呼び出しに使用するアクセス トークンを受け取る場合は、そのトークンを使用してアクセスできる API を指定する必要があります。
Curation Partners API の場合、そのスコープは https://www.googleapis.com/auth/curation-partners です。
API とリアルタイム キュレーションでデータセグメントを識別する方法
Curation Partners API では、データセグメントは次のような API 固有の リソース名 で識別されます。
"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".
リアルタイム キュレーションで広告配信予想数に関連するデータ セグメントを識別する場合は、DATA_SEGMENT_ID リソース ID の値を、フィールドの API から提供される完全なnameリソース名ではなく指定します。