このページは Cloud Translation API によって翻訳されました。

認証

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

OAuth2 認証情報を作成する

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

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

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

OAuth2 認証タイプを選択する
サービスアカウント	自社のアドマネージャーデータにのみアクセスする場合は、このオプションを選択します。詳しくはこちらをご覧ください。
ウェブアプリケーション	Google アカウントへのアクセス権を付与するすべてのユーザーとして認証する場合は、これを選択します。アドマネージャーデータへのアクセス権限をアプリケーションに付与する必要があります。詳しくはこちらをご覧ください。

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

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

サービスアカウント

<ph type="x-smartling-placeholder"></ph>を開きます。 Google API Console の [認証情報] ページをご覧ください。
プロジェクトのプルダウンで [新しいプロジェクトを作成] を選択し、名前を入力します。指定し、必要に応じて、指定されたプロジェクト ID を編集します。[ 作成:
[認証情報] ページで [認証情報を作成] を選択し、 [Service account key] を選択します。
[新しいサービスアカウント] を選択し、[JSON] を選択します。
[Create] をクリックして、秘密鍵を含むファイルをダウンロードします。

</ph>

ウェブアプリケーション

<ph type="x-smartling-placeholder"></ph>を開きます。 Google API Console の [認証情報] ページをご覧ください。
プロジェクトのプルダウンで [新しいプロジェクトを作成] を選択し、名前を入力します。（必要に応じてプロジェクト ID を編集します）、[ 作成:
[認証情報] ページで [認証情報を作成] を選択し、 [OAuth クライアント ID] を選択します。
プロダクト名の設定を求められる場合があります。同意画面ページ[同意画面を設定] をクリックします。必要な情報を入力して [Save] をクリックすると、 [Credentials] ページ。
[アプリケーションのタイプ] は [ウェブアプリケーション] を選択します。詳しくは、 JavaScript 生成元、リダイレクト URI、またはその両方を入力します。
[作成] をクリックします。
表示されたページで、クライアント ID とクライアントシークレットをコピーします。クリップボードにコピーできます。クライアントの構成時に必要になります。ライブラリです。

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

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

サービスアカウント

アドマネージャーネットワークに移動します。
[管理者] タブをクリックします。
[API アクセス] が有効になっていることを確認します。
[サービスアカウントユーザーを追加] ボタンをクリックします。
サービスアカウントのメールアドレスを使用してフォームに入力します。「サービスアカウントユーザーには、サービスアカウントに対するそのサービスアカウントユーザーが Compute Engine のできます。
[Save] ボタンをクリックします。確認のメッセージが表示されます。サービスアカウントを追加できます
[ユーザー] タブに移動して既存のサービスアカウントユーザーを表示し、 [サービスアカウント] フィルタをクリックします。

</ph>

ウェブアプリケーション

アドマネージャーネットワークに移動します。
[管理者] タブをクリックします。
[API アクセス] が有効になっていることを確認します。

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

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

Java

.NET

Python

PHP

Ruby

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`	アドマネージャーでキャンペーンを表示、管理します。

認証