API アクセスを設定する

ユーザー アカウント

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

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

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

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

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

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

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

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

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

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

   5. Google Cloud コンソールの [Audience] に移動し、[Publishing status] と [User type] を更新します。これらの設定について詳しくは、アプリのオーディエンスを管理するをご覧ください。

3. [OAuth2 クライアントを作成] をクリックしてプロジェクトに OAuth2 クライアントを作成するか、手順に沿って Desktop OAuth2 クライアントを作成します。Data Manager API で使用する Desktop 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"
   

   データマネージャー 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"
   

   データマネージャー 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 アカウントの認証情報を使用する場合は、[広告主] を選択します。
• データ パートナー アカウントのユーザーである Google アカウントの認証情報を使用して、データ パートナー アカウントへのパートナー リンクがある広告主アカウントを管理する場合は、[データ パートナー] を選択します。データ パートナー アカウントは、承認プロセスが完了した後にのみ発行されます。ご利用を始めるには、お問い合わせフォームにご記入ください。