API アクセスを設定する

ユーザー アカウント

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

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

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

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

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

2. Data Manager API スコープは機密性の高いスコープであるため、次の 手順が必要です。

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

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

   3. スコープのリストで [Data Manager API] の横にあるチェックボックスをオンにして、[更新] をクリックします。

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

   5. Google Cloud コンソールで [ユーザー] に移動し、[公開ステータス] と [ユーザータイプ] を更新します。これらの設定について詳しくは、 アプリのユーザーを管理するをご覧ください。

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で同じ認証情報を使用する場合は、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"
   

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

   gcloud auth application-default print-access-token
   

サービス アカウント

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

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

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

2. サービス アカウントにService Usage Consumerの 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. Google アカウントに、サービス アカウントに対する サービス アカウント トークン 作成者の IAM ロール（roles/iam.serviceAccountTokenCreator）を付与します。

   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で同じ認証情報を使用する場合は、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 アカウントとしてログインします。

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

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

ユーザー アカウント

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

• 管理する広告主アカウントのユーザーである Google アカウントの認証情報を使用する場合は、[**広告主**] を選択します。
• データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用し、データ パートナー アカウントへのパートナー リンクがある広告主アカウントを管理する場合は、[データ パートナー] を選択します。

サービス アカウント

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

• 管理する広告主アカウントのユーザーである Google アカウントの認証情報を使用する場合は、[**広告主**] を選択します。
• データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用し、データ パートナー アカウントへのパートナー リンクがある広告主アカウントを管理する場合は、[データ パートナー] を選択します。