Authentication

Google Ad Manager API の呼び出しはすべて、オープン スタンダードである OAuth2 を使って認証する必要があります。 ユーザーがサードパーティ アプリケーションに権限を付与できるため、 アプリケーションがユーザーに代わってウェブサービスとやり取りできます。OAuth2 により、 ユーザーのアド マネージ��ー アカウントにアクセスするための Ad Manager API クライアント アプリケーションから ユーザーのユーザー名とパスワードの処理や保存の必要がありません。

OAuth2 認証情報を作成する

OAuth2 認証情報を生成する手順は次のとおりです。

1. 認証タイプを決定する

以下の表で、最適な認証タイプを確認してください アド マネージャー API アプリケーションに:

OAuth2 認証タイプを選択する
サービス アカウント

自社のアド マネージャー データにのみアクセスする場合は、このオプションを選択します。

詳しくはこちらをご覧ください。
ウェブ アプリケーション

Google アカウントへのアクセス権を付与するすべてのユーザーとして認証する場合は、これを選択します。 アド マネージャー データへのアクセス権限をアプリケーションに付与する必要があります。

詳しくはこちらをご覧ください。

2. OAuth2 認証情報を作成する

認証タイプを決定したら、対応するタブをクリックします。 にアクセスして、手順に沿って OAuth2 認証情報を生成します。

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph>
サービス アカウント
  1. <ph type="x-smartling-placeholder"></ph>を開きます。 Google API Console の [認証情報] ページをご覧ください。
  2. プロジェクトのプルダウンで [新しいプロジェクトを作成] を選択し、名前を入力します。 指定し、必要に応じて、指定されたプロジェクト ID を編集します。[ 作成:
  3. [認証情報] ページで [認証情報を作成] を選択し、 [Service account key] を選択します。
  4. [新しいサービス アカウント] を選択し、[JSON] を選択します。
  5. [Create] をクリックして、秘密鍵を含むファイルをダウンロードします。
で確認できます。
<ph type="x-smartling-placeholder">
</ph>
ウェブ アプリケーション
  1. <ph type="x-smartling-placeholder"></ph>を開きます。 Google API Console の [認証情報] ページをご覧ください。
  2. プロジェクトのプルダウンで [新しいプロジェクトを作成] を選択し、名前を入力します。 （必要に応じてプロジェクト ID を編集します）、[ 作成:
  3. [認証情報] ページで [認証情報を作成] を選択し、 [OAuth クライアント ID] を選択します。
  4. プロダクト名の設定を求められる場合があります。 同意画面ページ[同意画面を設定] をクリックします。 必要な情報を入力して [Save] をクリックすると、 [Credentials] ページ。
  5. [アプリケーションのタイプ] は [ウェブ アプリケーション] を選択します。詳しくは、 JavaScript 生成元、リダイレクト URI、またはその両方を入力します。
  6. [作成] をクリックします。
  7. 表示されたページで、クライアント ID とクライアント シークレットをコピーします。 クリップボードにコピーできます。クライアントの構成時に必要になります。 ライブラリです。
Client ID and client secret screenshot

3. アド マネージャー ネットワークを設定する

サードパーティのデベロッパーは、クライアントにこの設定を行わなければならない場合があります。 自動的に行われます。

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph>
サービス アカウント
  1. アド マネージャー ネットワークに移動します。
  2. [管理者] タブをクリックします。
  3. [API アクセス] が有効になっていることを確認します。
  4. [サービス アカウント ユーザーを追加] ボタンをクリックします。
  5. サービス アカウントのメールアドレスを使用してフォームに入力します。「 そのサービス アカウントのユーザーに、サービス アカウントの そのサービス アカウント ユーザーが Compute Engine の できます。
  6. [Save] ボタンをクリックします。次の内容を確認するメッセージが表示されます。 サービスアカウントを追加できます
  7. [ユーザー] タブに移動して既存のサービス アカウント ユーザーを表示し、 [サービス アカウント] フィルタをクリックします。
で確認できます。
<ph type="x-smartling-placeholder">
</ph>
ウェブ アプリケーション
  1. アド マネージャー ネットワークに移動します。
  2. [管理者] タブをクリックします。
  3. [API アクセス] が有効になっていることを確認します。

4. クライアント ライブラリを設定して使用する

以下の適切なガイドに沿って、クライアント ライブラリの認証情報を使用します。

Google のクライアント ライブラリを使用しない場合は、実装する必要があります。 OAuth2 サービス アカウントまたはウェブ ユーザー自身で行えます

舞台裏

以下で説明するように、クライアント ライブラリによって自動的に処理されます。 裏で行われていることに関心がある場合にのみ、以下をお読みください。 このセクションは、すでに使い慣れている上級ユーザーを対象としています。 OAuth2 仕様と Google API で OAuth2 を使用する方法を確認する。

HTTP リクエスト ヘッダー

Ad Manager API に対するリクエストの HTTP ヘッダーには必ず、 次の形式にします。

Authorization: Bearer ACCESS_TOKEN

例:

POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>

範囲

1 つのアクセス トークンで複数の API にさまざまなレベルのアクセス権を付与できます。 scope という変数パラメータが、リソースのセットを制御し、 アクセス トークンで許可される操作を制御します。アクセス トークンのリクエストの間、 scope パラメータで 1 つ以上の値を送信する。

アド マネージャーのスコープは 1 つのみです。承認を受ける必要がある ユーザーレベルで定義できます

範囲 権限
https://www.googleapis.com/auth/dfp アド マネージャーでキャンペーンを表示、���理します。