ディスプレイ&ビデオ 360 Exchange Reporting API のオンボーディングと OAuth の設定

DV360 Exchange Reporting API を使用すると、サードパーティ エクスチェンジ（3PE）パートナーは、ディスプレイ＆ビデオ 360 のパフォーマンス レポートにプログラマティックにアクセスできます。

ディスプレイ＆ビデオ 360 エクスチェンジ Reporting API は、OAuth を使用する許可リスト ベースの Google Cloud API として公開されています。許可リストのプロセスは、ディスプレイ＆ビデオ 360 エクスチェンジ Reporting API チームが処理します。

手順

ディスプレイ＆ビデオ 360 取引レポート API のオンボーディング手順は次のとおりです。

  1. Google Cloud コンソールで Google アカウントに登録します。

    このアカウントは本番環境クライアントのアクセス トークンを管理するために使用されるため、個人の Gmail アカウントは使用しないでください。

  2. アカウント情報を添えて Google ディスプレイ＆ビデオ 360 に連絡し、許可リストに追加してもらいます。

  3. 許可リストに登録されたという通知を受け取ったら、OAuth 認証の審査をリクエストして、アプリが doubleclickbidmanager スコープにアクセスできるようにします。

  4. Google Cloud コンソールにログインします。

    [API とサービス] > [ライブラリ] > [非公開] に移動します。利用可能な API の 1 つとして、DV360 Exchange Reporting API が表示されます。DV360 Exchange Reporting API を有効にします。

  5. [認証情報] > [認証情報を作成] > [サービス アカウント キー] に移動します。サービス アカウントを作成する手順に沿って操作します。

サービス アカウント

サービス アカウントを使用すると、アプリケーションの認証情報をコードで API に直接送信できます。サービス アカウントは、ユーザー アカウントと同様にメールアドレスで表されます。ただし、ユーザー アカウントとは異なり、サービス アカウントはアプリケーションにのみ属し、作成された API へのアクセスにのみ使用できます。

Google Cloud コンソールを使用してサービス アカウントの認証情報を作成する手順は次のとおりです。

  1. [API Manager > 認証情報] ページで、[認証情報を作成] > [サービス アカウント キー] を選択します。

  2. [サービス アカウント] プルダウンから [新しいサービス アカウント] を選択します。

    このサービス アカウントの名前を入力します。この名前は、生成されたサービス アカウント ID アドレスの @ の左側にあるサービス アカウント ID のデフォルト名として使用されます。

    [キータイプ] の値は JSON のままにしておくことをおすすめします。[作成] をクリックして、JSON 鍵を .json テキスト ファイルとして生成します。メッセージが表示されたら、ファイルをパソコンにダウンロードします。[サービス アカウントが作成されました] ダイアログ ボックスが表示されます。

    JSON キーの例を次に示します。

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. この JSON ファイルには秘密鍵が含まれており、このファイルはその唯一のコピーであるため、安全な場所に保管してください。このファイルの認証情報は、コードが API を呼び出すときに必要になります。

  4. 作成したサービス アカウントの情報（特にサービス アカウントのメールアドレス）を添えて、ディスプレイ＆ビデオ 360 にお問い合わせください。これは、API アクセスの許可リスト登録プロセスの一環です。

アクセス トークン

サービス アカウントが API を呼び出す権限を付与されたら、API ガイドの例に進むことができます。アクセス トークンを手動で取得するには、oauth2l などのツールを使用するか、クライアント ライブラリのいずれかを使用してプログラムで認証します。