Auth の設定

ディスプレイ＆ビデオ 360 Seller API のオンボーディング

ディスプレイ＆ビデオ 360 Seller API のオンボーディングには、いくつかの重要な手順があります。DV360 Seller API は、許可リストに基づく Google Cloud API であり、認証と認可に OAuth 2.0 を使用します。

許可リストへの登録プロセスは、ディスプレイ＆ビデオ 360 Seller API チームが処理します。

オンボーディングの手順は次のとおりです。

  1. https://console.cloud.google.com/ にアクセスして Google アカウントに登録します。
    • このアカウントは、本番環境クライアントのアクセス トークンを管理するために使用されます。個人の Gmail アカウントは使用しないでください。
    • アカウントに Google グループを指定することはできません。
    • 既存の Google Cloud プロジェクトを使用している場合: アカウントはプロジェクトの管理者である必要があります。
  2. アカウントの詳細を Google DV360 チームに連絡して、許可リストに追加してもらいます。
  3. アカウントが有効になったという確認の連絡を待ちます。
  4. 省略可（ブロックされない）: アプリケーションの OAuth 検証 審査 リクエストを送信して、https://www.googleapis.com/auth/doubleclickbidmanager スコープにアクセスします。
  5. [Google Cloud コンソール] で、[API とサービス] > [ライブラリ] > [プライベート] に移動します。プロジェクトで DV360 Seller API が使用可能になっているはずです。
  6. DV360 Seller API を有効にします。
  7. [API とサービス] > [認証情報] > [認証情報を作成] > [サービス アカウント キー] に移動します。OAuth 2.0 サービス アカウントのドキュメントの設定手順に沿って設定します。

    サービス アカウントを設定します。

    注: DV360 Reporting API で使用しているサービス アカウントなど、既存のサービス アカウントを再利用する場合はお知らせください。

    Google Cloud API の認証と認可（通常は「auth」としてグループ化）は通常、サービス アカウントを使用して行われます。サービス アカウントを使用すると、アプリケーションの認証情報をコードで Cloud API に直接送信できます。サービス アカウントは、ユーザー アカウントと同様に、メールアドレスで示されます。ただし、ユーザー アカウントとは異なり、サービス アカウントはアプリケーションにのみ属し、作成された API へのアクセスにのみ使用できます。例として、Google Cloud Platform Console を使用してサービス アカウントの認証情報を作成する方法を示します。

    Google Cloud コンソール の使用

    Google Cloud コンソールで [API Manager] → [認証情報] に移動し、[認証情報を作成] → [サービス アカウント キー] を選択します。

    alt_text

    次に、[サービス アカウント] プルダウンで [新しいサービス アカウント] を選択します。

    alt_text

    [名前] にこのサービス アカウントの名前を入力します。この名前は「サービス アカウント ID」（生成されたサービス アカウント ID アドレスの「@」の左側）のデフォルト名として使用されますが、必要に応じて変更できます。名前は何でも構いません。重要なのは、その名前を覚えておくことです。[キーのタイプ] は [JSON] のままにしておくことをおすすめします。[作成] をクリックすると、JSON キーが .json テキスト ファイルとして生成されます。ファイルをパソコンにダウンロードするように指示され、[サービス アカウントが作成されました] ダイアログ ボックスが表示されます。

    alt_text

    生成された 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"
}

    この JSON ファイルには秘密鍵が含まれているため、安全な場所に保管してください（このファイルはその唯一のコピーです）。Google Cloud Platform API に認証情報を送信する場合は、コード内でこのサービス アカウント キーファイルを参照する必要があります。

  8. 作成したサービス アカウント の情報（特にサービス アカウントのメールアドレス）を DV360 チームに連絡します。これは、認可のための 2 回目の許可リスト登録の手順です。
  9. サービス アカウントが API の呼び出しを認可されたら、DV360 Seller API のドキュメントを参照できます。認証トークンを手動で取得するには、oauth2l ツールのリポジトリの手順（ダウンロードした JSON サービス アカウント キーを使用）をご覧ください。OAuth トークンをプログラムで取得する詳細な手順については、Google Cloud 認証のドキュメントをご覧ください。

重要: OAuth スコープは https://www.googleapis.com/auth/doubleclickbidmanager にする必要があります。

前へ
概要
次へ
クライアント ライブラリ