SDK または REST を使用して Data Manager API へのアクセスを設定する方法は次のとおりです。
前提条件
Google Cloud プロジェクトまたはプロジェクトの所有者にする Google アカウント。
- プロジェクトがない場合、次のセクションの設定プロセスで プロジェクトが作成されます。
プロジェクトがすでにある場合、Google アカウントに、プロジェクトで API を有効にできる ロール（ オーナー、編集者、 または サービス利用管理者など）があることを確認します。ロールを確認するには、Google Cloud コンソールで [IAM] ページを開き、 プロジェクトを選択して、リストで Google アカウントを見つけます。
詳細については、現在のアクセス権を表示するをご覧ください。
Google Cloud CLI が インストールされている。
API を有効にする
まだ有効にしていない場合は、 Google Cloud プロジェクトで Data Manager API を有効にします。[Data Manager API を有効にする] をクリックするか、 手順に沿って この手順を手動で実行します。
Data Manager API を有効にするData Manager API が見つからない場合や、[Data Manager API を有効にする] が失敗する場合は、 Google アカウントが前提条件を満たしていることを確認してください。
認証を設定する
Google では、API キー以外にもさまざまな認証方法を使用できます。ユース ケースに適した認証方法を選択するで、ユースケースに適した 方法を選択する方法を確認することをおすすめ します。
一般的な認証方法には、ユーザー アカウントとサービス アカウントの 2 つがあります。
- ユーザー アカウント: Google API や サービスを直接操作するユーザーを表します。
- サービス アカウント: ユーザーとして人間ではなくアプリを表します。アプリで認証と認可を管理できます。たとえば、アプリが Google Cloud リソースにアクセスする必要がある場合などです。
統合では、アプリケーションのデフォルト認証情報（ADC）を使用して 環境から認証情報を自動的に検出できるため、 認証のためにクライアント コードを変更する必要はありません。
[ユーザー アカウント] または [サービス アカウント] を選択して ADC を設定します。
ユーザー アカウント
ユーザー アカウント の認証情報を使用して認証を行う手順は次のとおりです。
プロジェクトの Google Auth Platform の設定を構成します。
Google Cloud コンソールで [ブランディング] ページ を開きます。
プロジェクトを選択します。
フォームに入力し、[作成] をクリックします。
Data Manager API は機密性の高いスコープを使用するため、 次の手順が必要です。
プロジェクトのデータアクセス設定に移動します。
[スコープを追加または削除] をクリックします。
スコープのリストで [Data Manager API] を見つけ、アプリケーションに必要なスコープのチェックボックスをオンにします。
.../auth/datamanager: 顧客データ、オーディエンス、イベントの管理など、標準の API オペレーションにはこのスコープを選択します。このガイド全体で使用されるプライマリ スコープです。.../auth/datamanager.partnerlink: このスコープは、 データ パートナーが 広告主アカウントでパートナー リンクを作成または削除する場合にのみ選択します。
[更新] をクリックします。
[保存] をクリックします。
Google Cloud コンソールで [オーディエンス] に移動し、初期開発の設定を構成します。
- [公開ステータス] を [テスト] に設定します。
- [ユーザーの種類] を [内部]（プロジェクトが Google Workspace 組織にある場合）または [外部]（プロジェクトが Google Workspace 組織にない場合）に設定します。
- [外部] を使用する場合は、認証情報の生成に使用する Google アカウントを [テストユーザー] として追加します。
これらの設定について詳しくは、 アプリのオーディエンスを管理するをご覧ください。
[OAuth2 クライアントを作成] をクリックしてプロジェクトに OAuth2 クライアントを作成します。または、手順 に沿って [デスクトップ] OAuth2 クライアントを作成します。Data Manager API で使用するデスクトップ OAuth2 クライアントがすでにある場合は、この手順をスキップできます。
[OAuth2 クライアントを作成] をクリックした場合は、[デスクトップ アプリ] を選択して、 [OAuth クライアントを構成する] というメッセージが表示されたら残りの手順でクライアントを使用できるようにします。
OAuth2 クライアントを作成する最後の手順で、[クライアント構成をダウンロード] をクリックし、選択したダウンロード場所をメモします。
次のコマンドを実行して、ローカル 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で同じ認証情報を使用する場合は、Google Ads API スコープを
--scopesリストに含めます。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で同じ認証情報を使用する場合は、Display & Video 360 API スコープを
--scopesリストに含めます。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"次のコマンドを使用して、認証情報が正しく設定されていることを確認します。 成功すると、コンソールにアクセス トークンが出力されます。
gcloud auth application-default print-access-token
サービス アカウント
サービス アカウントを作成し、サービス アカウント の権限借用を使用してローカル 開発環境で認証を行う手順は次のとおりです。サービス アカウント キーの管理は 慎重に行ってください。扱いを誤ると、セキュリティ上のリスクが生じる可能性があるため、これらの手順ではサービス アカウント キーではなく権限借用を使用します。
次の [サービス アカウントを作成] ボタンをクリックするか、 手順に沿って サービス アカウントを選択または作成します。
サービス アカウントの作成サービス アカウントに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"Google アカウントに、サービス アカウントに対するサービス アカウント トークン 作成者 IAM ロール（
roles/iam.serviceAccountTokenCreator）を付与します。gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \ --member="user:USER_EMAIL" \ --role="roles/iam.serviceAccountTokenCreator"次のコマンドを実行して 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で同じ認証情報を使用する場合は、Google Ads API スコープを
--scopesリストに含めます。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で同じ認証情報を使用する場合は、Display & Video 360 API スコープを
--scopesリストに含めます。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 アカウントとしてログインします。
次のコマンドを使用して、認証情報が正しく設定されていることを確認します。成功すると、コンソールにアクセス トークンが出力されます。
gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"
アプリの認証と認証情報の詳細については、 Google の認証方法とアプリケーションのデフォルト認証情報の 仕組みをご覧ください。
アカウント アクセスを設定する
ユーザー アカウント
ユースケースに対応するタブを選択します。
- 管理する広告主アカウントのユーザーである Google アカウントの認証情報を使用する場合は、[**広告主様**] を選択します。
- データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用し、データ パートナー アカウントへのパートナー リンクがある広告主アカウントを管理する場合は、[データ パートナー] を選択します。データ パートナー アカウントは、承認プロセスを経てから 発行されます。まず、お問い合わせフォームにご記入ください 。
広告主様
ユーザーに関連付けられたメールアドレスに
Destinationへのアクセス権を付与します。
データ パートナー
ユーザーに関連付けられたメールアドレスにデータ パートナー アカウント へのアクセス権を付与します。通常、データ パートナーは API アクセスにサービス アカウントを使用します。 ただし、テストなどの目的でユーザー アカウントを使用する場合は、データ パートナー アカウントへのアクセス権をユーザー アカウントに付与する必要があります。
サービス アカウント
ユースケースに対応するタブを選択します。
- 管理する広告主アカウントのユーザーである Google アカウントの認証情報を使用する場合は、[**広告主様**] を選択します。
- データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用し、データ パートナー アカウントへのパートナー リンクがある広告主アカウントを管理する場合は、[データ パートナー] を選択します。データ パートナー アカウントは、承認プロセスを経てから 発行されます。まず、お問い合わせフォームにご記入ください 。
広告主様
サービス アカウントに関連付けられたメールアドレスに
Destinationへのアクセス権を付与します。
Google 広告
アカウント アクセスの設定 を完了して、サービス アカウントを Google 広告アカウントまたは親の Google 広告クライアント センター（MCC）アカウントに追加します。
ディスプレイ＆ビデオ 360
手順に沿って 、サービス アカウントに関連付けられたディスプレイ＆ビデオ 360 ユーザーを作成します。
Google アナリティクス
手順に沿って 、サービス アカウントのメールアドレスをアカウントに追加します。
データ パートナー
サービス アカウントに関連付けられたメールアドレスにデータ パートナー アカウント へのアクセス権を付与します。
データ パートナー アカウントのアクセス権は、Google 広告の UI で管理されます。サービス アカウントを追加してアクセスレベルを設定するには、 アカウント アクセスの設定の手順に沿って操作します。
次のステップ
- クライアント ライブラリをインストールし、 コードサンプルを実行して、最初の Data Manager API リクエストを試します。
- 本番環境にデプロイする際の 認証の構成方法について学習します。