API アクセスを設定する

SDK または REST を使用して Data Manager API へのアクセスを設定する方法は次のとおりです。

前提条件

  1. Google Cloud プロジェクト、またはプロジェクトを所有する Google アカウント。

    • プロジェクトがない場合は、次のセクションのセットアップ プロセスでプロジェクトが作成されます。

    • すでにプロジェクトがある場合は、Google アカウントに、プロジェクトで API を有効にできるロール（オーナー、編集者、Service Usage 管理者など）があることを確認します。ロールを確認するには、Google Cloud コンソールで [IAM] ページを開き、プロジェクトを選択して、リストで Google アカウントを見つけます。

      詳しくは、現在のアクセス権を確認するをご覧ください。

  2. Google Cloud CLI がインストールされている。

API を有効にする

まだ有効にしていない場合は、[Data Manager API を有効にする] をクリックして Google Cloud プロジェクトで Data Manager API を有効にするか、手順に沿ってこの手順を手動で行います。

Data Manager API を有効にする

Data Manager API が見つからない場合や、Data Manager API の有効化が失敗した場合は、Google アカウントが前提条件を満たしていることを確認してください。

認証を設定する

API キー以外の Google の認証方法を使用できます。ユースケースに適した認証方法を選択する方法を確認して、ユースケースに適したアプローチを決定することをおすすめします。

一般的な認証方法には、ユーザー アカウントとサービス アカウントの 2 つがあります。

  • ユーザー アカウント: Google API やサービスを直接操作するユーザーを表します。
  • サービス アカウント: ユーザーとして、人ではなくアプリを表します。これにより、アプリで認証と認可を管理できます。たとえば、アプリが Google Cloud リソースにアクセスする必要がある場合です。

統合では、アプリケーションのデフォルト認証情報（ADC）を使用して、環境から認証情報を自動的に検索できます。これにより、クライアント コードを変更して認証する必要がなくなります。

[ユーザー アカウント] または [サービス アカウント] を選択して、ADC を設定します。

ユーザー アカウント

ユーザー アカウントの認証情報で認証する手順は次のとおりです。

  1. プロジェクトの Google Auth Platform の設定を構成します。

    1. Google Cloud コンソールで [ブランディング] ページを開きます。

    2. プロジェクトを選択します。

    3. フォームに記入し、[作成] をクリックします。

  2. Data Manager API は機密スコープを使用するため、次の手順が必要です。

    1. プロジェクトの [データアクセス] 設定に移動します。

    2. [スコープを追加または削除] をクリックします。

    3. スコープのリストで [Data Manager API] を見つけ、アプリケーションに必要な各スコープのチェックボックスをオンにします。

      • .../auth/datamanager: 顧客データ、オーディエンス、イベントの管理など、標準の API オペレーションにこのスコープを選択します。これは、このガイド全体で使用されるプライマリ スコープです。

      • .../auth/datamanager.partnerlink: このスコープは、広告主アカウントでパートナー リンクを作成または削除するデータ パートナーの場合にのみ選択します。

    4. [更新] をクリックします。

    5. [保存] をクリックします。

    6. Google Cloud コンソールの [オーディエンス] に移動し、初期開発の設定を構成します。

      • [公開ステータス] を [テスト中] に設定します。
      • [ユーザーの種類] を [内部]（プロジェクトが Google Workspace 組織内にある場合）または [外部]（プロジェクトが Google Workspace 組織内にない場合）に設定します。
      • [外部] を使用する場合は、認証情報の生成に使用する Google アカウントをテストユーザーとして追加します。

      これらの設定について詳しくは、アプリの対象ユーザーを管理するをご覧ください。

  3. [OAuth2 クライアントを作成] をクリックしてプロジェクトに OAuth2 クライアントを作成するか、手順に沿ってデスクトップ OAuth2 クライアントを作成します。Data Manager API に使用するデスクトップ OAuth2 クライアントがすでにある場合は、この手順をスキップできます。

    [OAuth2 クライアントを作成] をクリックした場合は、[OAuth クライアントを構成する] で [デスクトップ アプリ] を選択します。これにより、残りの手順でクライアントを使用できるようになります。

    OAuth2 クライアントを作成する

    最後の手順で、[クライアント構成をダウンロード] をクリックし、選択したダウンロード先をメモします。

  4. 次のコマンドを実行して、ローカル ADC ファイルを生成します。このコマンドを実行すると、API で使用している Google アカウントへのログインを求めるウェブフローが起動します。

    PATH_TO_CLIENT_JSON は、ダウンロードした JSON ファイルの名前に置き換えます。

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Data Manager API と Google Ads API で同じ認証情報を使用する場合は、--scopes リストに Google Ads API スコープを含めます。

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Data Manager API と Display & Video 360 API で同じ認証情報を使用する場合は、--scopes リストに Display & Video 360 API スコープを含めます。

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. 次のコマンドを使用して、認証情報が正しく設定されていることを確認します。成功すると、コマンドはアクセス トークンをコンソールに出力します。

    gcloud auth application-default print-access-token

サービス アカウント

サービス アカウントを作成し、サービス アカウントの権限借用を使用してローカル開発環境で認証する手順は次のとおりです。これらの手順では、サービス アカウント キーではなく、権限借用を使用します。サービス アカウント キーは、慎重に管理しないとセキュリティ リスクになる可能性があります。

  1. 次の [サービス アカウントを作成] ボタンをクリックするか、手順に沿ってサービス アカウントを選択または作成します。

    サービス アカウントの作成

  2. サービス アカウントに Service Usage コンシューマー IAM ロール（roles/serviceusage.serviceUsageConsumer）を付与します。これには、サービス アカウントがプロジェクトの API リクエストを送信できるようにする serviceusage.services.use 権限が含まれています。

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. サービス アカウントに対するサービス アカウント トークン作成者の IAM ロール（roles/iam.serviceAccountTokenCreator）を Google アカウントに付与します。

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. 次のコマンドを実行して ADC を構成します。

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

    Data Manager API と Google Ads API で同じ認証情報を使用する場合は、--scopes リストに Google Ads API スコープを含めます。

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

    Data Manager API と Display & Video 360 API で同じ認証情報を使用する場合は、--scopes リストに Display & Video 360 API スコープを含めます。

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    ログインを求められたら、サービス アカウント トークン作成者のロールを持つ Google アカウントとしてログインします。

  5. 次のコマンドを使用して、認証情報が正しく設定されていることを確認します。成功すると、コマンドはアクセス トークンをコンソールに出力します。

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

アプリの認証と認証情報の詳細については、Google での認証方法とアプリケーションのデフォルト認証情報の仕組みをご覧ください。

アカウントへのアクセスを設定する

ユーザー アカウント

ユースケースに対応するタブを選択します。

  • 管理する広告主アカウントのユーザーである Google アカウントの認証情報を使用する場合は、[広告主] を選択します。
  • データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用し、データ パートナー アカウントへのパートナー リンクがある広告主アカウントを管理する場合は、[データ パートナー] を選択します。データ パートナー アカウントは、承認プロセスを経てから発行されます。まずは、お問い合わせフォームにご記入ください。

広告主様

ユーザーに関連付けられているメールアドレスに Destination へのアクセス権を付与します。

手順に沿って、ユーザーのメールアドレスを Google 広告アカウントまたは親の Google 広告 MCC アカウントに追加します。

ディスプレイ＆ビデオ 360

手順に沿って、ユーザーのメールアドレスをアカウントに追加します。

Google アナリティクス

手順に沿って、ユーザーのメールアドレスをアカウントに追加します。

データ パートナー

ユーザーに関連付けられたメールアドレスに、データ パートナー アカウントへのアクセス権を付与します。通常、データ パートナーは API アクセスにサービス アカウントを使用します。ただし、テストなどの目的でユーザー アカウントを使用する場合は、ユーザー アカウントにデータ パートナー アカウントへのアクセス権を付与する必要があります。

こちらの手順に沿って、Google 広告の管理画面からデータ パートナー アカウントにユーザーのメールアドレスを追加します。

サービス アカウント

ユースケースに対応するタブを選択します。

  • 管理する広告主アカウントのユーザーである Google アカウントの認証情報を使用する場合は、[広告主] を選択します。
  • データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用し、データ パートナー アカウントへのパートナー リンクがある広告主アカウントを管理する場合は、[データ パートナー] を選択します。データ パートナー アカウントは、承認プロセスを経てから発行されます。まずは、お問い合わせフォームにご記入ください。

広告主様

サービス アカウントに関連付けられたメールアドレスに Destination へのアクセス権を付与します。

アカウント アクセスの設定を完了して、サービス アカウントを Google 広告アカウントまたは親 Google 広告 MCC アカウントに追加します。

ディスプレイ＆ビデオ 360

手順に沿って、サービス アカウントに関連付けられたディスプレイ＆ビデオ 360 ユーザーを作成します。

Google アナリティクス

手順に沿って、サービス アカウントのメールアドレスをアカウントに追加します。

データ パートナー

サービス アカウントに関連付けられたメールアドレスに、データ パートナー アカウントへのアクセス権を付与します。

データ パートナーのアカウント アクセスは、Google 広告の管理画面で管理されます。サービス アカウントを追加してアクセスレベルを設定するには、アカウント アクセスの設定の手順に沿って操作します。

次のステップ

次へ
クライアント ライブラリをインストールする