認証

DFP API のすべての呼び出しは、オープンスタンダードである OAuth 2.0 を使って認証する必要があります。OAuth 2.0 によってユーザーは、第三者アプリケーションに対し、自分に代わってウェブサービスとやり取りする権限を付与することができます。つまり、OAuth 2.0 を使用すると、DFP API クライアントアプリケーションは、ユーザー名やパスワードの処理や保存を行うことなくユーザーの DFP アカウントにアクセスできるようになります。

OAuth 2.0 認証情報を作成する

OAuth 2.0 認証情報を作成する手順は以下のとおりです。

1. 認証の種類を決める

以下の表で、対象の DFP API アプリケーションに最適な認証の種類を確認します。

OAuth 2.0 認証の種類を選択する
サービスアカウント	自分の DFP データにアクセスするだけでよい場合に選択します。詳細
ウェブアプリケーション	アプリケーションに DFP データへのアクセスを許可する任意のユーザーとして認証を行う場合に選択します。詳細

2. OAuth 2.0 認証情報を作成する

認証の種類を決めたら以下で該当するタブをクリックし、手順に沿って OAuth 2.0 認証情報を作成します。

サービスアカウント

Google API Console の認証情報ページを開きます。
プロジェクトのプルダウンメニューから [プロジェクトを作成] を選択し、プロジェクトの名前を入力します（表示されているプロジェクト ID は任意で編集することもできます）。[作成] をクリックします。
認証情報ページで [認証情報を作成] を選択し、[サービスアカウントキー] を選択します。
[新しいサービスアカウント] を選択し、[JSON] を指定します。
[作成] をクリックして、秘密鍵を含むファイルをダウンロードします。

ウェブアプリケーション

Google API Console の認証情報ページを開きます。
プロジェクトのプルダウンメニューから [新しいプロジェクトを作成] を選択し、プロジェクトの名前を入力します（表示されているプロジェクト ID は任意で編集することもできます）。[作成] をクリックします。
認証情報ページで [認証情報を作成] をクリックし、[OAuth クライアント ID] を選択します。
同意画面のページでプロダクト名の設定を促された場合は、[同意画面を設定] をクリックして必要な情報を入力し、[保存] をクリックして認証情報ページに戻ります。
[アプリケーションのタイプ] は [ウェブアプリケーション] を選択します。手順に従って JavaScript の生成元かリダイレクト URI（またはその両方）を入力します。
[作成] をクリックします。
表示されたページでクライアント ID とクライアントシークレットをクリップボードにコピーします。この 2 つはクライアントライブラリの設定時に必要になります。

3. DFP ネットワークを設定する

お客様が第三者デベロッパーの場合、状況によってはこの作業をクライアントに依頼していただく必要があります。

サービスアカウント

DoubleClick for Publishers ネットワークを開きます。
[管理者] タブをクリックします。
[API アクセス] が有効になっていることを確認します。
[サービスアカウントユーザーを追加] をクリックします。
フォームにサービスアカウントのメール情報を入力します。サービスアカウントユーザーには、管理画面からエンティティにアクセスするための権限が付与されている必要があります。
[保存] をクリックします。サービスアカウントの追加を確認するメッセージが表示されます。
[ユーザー] タブに移動して既存のサービスアカウントのユーザーを確認した後、[サービスアカウント] フィルタをクリックします。

ウェブアプリケーション

DoubleClick for Publishers ネットワークを開きます。
[管理者] タブをクリックします。
[API アクセス] が有効になっていることを確認します。

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

クライアントライブラリで認証情報を使用するには、以下のガイドをご覧ください。

Google が提供しているクライアントライブラリを使用しない場合は、OAuth 2.0 のサービスアカウントまたはウェブアプリのフローをご自分で行う必要があります。

具体的な仕組み

クライアントライブラリでは、以下の処理が自動的に行われます。バックグラウンド処理の内容にご関心がある場合にご覧ください。このセクションは、OAuth 2.0 の仕様と Google API で OAuth 2.0 を使用する方法を理解している上級者の方を対象としています。

HTTP リクエストヘッダー

DFP 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 パラメータの値が送信されます。

DFP のスコープは次の 1 つのみです。認証は、プロダクト内でユーザーレベルで行う必要があります。

スコープ	権限
`https://www.googleapis.com/auth/dfp`	DoubleClick for Publishers でのキャンペーンの表示と管理

認証

OAuth 2.0 認証情報を作成する

1. 認証の種類を決める

2. OAuth 2.0 認証情報を作成する

3. DFP ネットワークを設定する

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

Java

.NET

Python

PHP

Ruby

具体的な仕組み

HTTP リクエスト ヘッダー

スコープ

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

HTTP リクエストヘッダー