API アクセスを設定する

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

行う設定プロセスの種類を選択します。

前提条件

Data API を使用する前に、次のものを用意しておきます。

Google Cloud プロジェクト。
Google Cloud プロジェクトに対する serviceusage.services.enable 権限を持つ Google アカウント、またはその権限を含むロールを持つ Google アカウント。たとえば、roles/owner と roles/serviceusage.serviceUsageAdmin の両方に serviceusage.services.enable 権限が含まれています。権限を確認するには、現在のアクセス権を表示するをご覧ください。
Google Cloud コマンドラインインターフェースがインストールされている。

API を有効にする

まだ有効にしていない場合は、[データマネージャー API を有効にする] をクリックするか、手順に沿ってこの手順を手動で実行して、データマネージャー API を有効にします。

データマネージャー API が見つからない場合や、データマネージャー API の有効化に失敗した場合は、Google アカウントが前提条件を満たしていることを確認します。

認証を設定する

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

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

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

統合では、アプリケーションのデフォルト認証情報（ADC）を使用して環境から認証情報を自動的に検出できるため、認証を行うためにクライアントコードを変更する必要はありません。

ADC を設定するには、[ユーザーアカウント] または [サービスアカウントの権限借用] を選択します。

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

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

重要: Data Manager API スコープのユーザー認証情報を取得するために使用される Google Cloud アプリは、ユーザーに未確認の UI 画面が表示されないように、Google OAuth 認証を受ける必要があります。サービスアカウントでは Google OAuth の確認は必要ありません。
1. Google Cloud コンソールで [ブランディング] ページを開きます。
2. プロジェクトを選択します。
3. フォームに記入し、[作成] をクリックします。
Data Manager API スコープは機密性の高いスコープであるため、次の手順が必要です。
1. プロジェクトの [データアクセス] 設定に移動します。
2. [スコープを追加または削除] をクリックします。
3. スコープのリストで [Data Manager API] の横にあるチェックボックスをオンにして、[更新] をクリックします。
4. [保存] をクリックします。
5. Google Cloud コンソールの [ユーザー] に移動し、[公開ステータス] と [ユーザータイプ] を更新します。これらの設定について詳しくは、アプリユーザーを管理するをご覧ください。
[OAuth2 クライアントを作成] をクリックしてプロジェクトに OAuth2 クライアントを作成するか、手順に沿って Desktop OAuth2 クライアントを作成します。Data Manager API で使用する Desktop 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"
```
データマネージャー 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"
```
次のコマンドを使用して、認証情報が正しく設定されていることを確認します。成功すると、コマンドはアクセストークンをコンソールに出力します。
```
gcloud auth application-default print-access-token
```

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

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

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

Google 広告アカウントを使用している場合は、手順に沿って、ユーザーのメールアドレスを Google 広告アカウントまたは親 Google 広告クライアントセンター（MCC）アカウントに追加します。
ディスプレイ＆ビデオ 360 アカウントを使用している場合は、手順に沿って、ユーザーのメールアドレスをアカウントに追加します。
Google アナリティクスプロパティを使用している場合は、手順に沿って、ユーザーのメールアドレスをアカウントに追加します。

次のステップ

クライアントライブラリをインストールし、サンプルコードを実行して、最初の Data Manager API リクエストを試します。

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