OAuth2 Playground

OAuth2 認証情報を生成する方法の一つとして、OAuth2 Playground を使用する方法があります。OAuth2 Playground と Google Ads API コンソールを併用すれば、手動で OAuth2 トークンを生成できます。

OAuth2 Playground は、1 つのクライアント センター（MCC）アカウントまたは 1 人の Google 広告ユーザーのアカウントのみにアクセスする必要があるユーザーに適しています。複数のユーザーに認証情報をリクエストする場合は、検索広告 360 で OAuth 用のクライアント ライブラリを構成することをおすすめします。

クライアント ID とクライアント シークレットを作成する

警告: OAuth2 Playground を使用するには、ウェブ アプリケーション用にクライアント ID を生成する必要があります。OAuth2 Playground と併用できるのはこのタイプのアプリケーションのみです。詳細については、アプリケーションのタイプを選択するをご覧ください。

既存の Cloud プロジェクトがない場合:

1. Google API Console の認証情報ページを開きます。

2. プロジェクトのメニューで既存のプロジェクトを選択するか、新しいプロジェクトを作成します。

3. 認証情報のページで [認証情報を作成] をクリックし、[OAuth クライアント ID] を選択します。

4. [アプリケーションのタイプ] に [ウェブ アプリケーション] を選択します。

5. [承認済みのリダイレクト URI] に、https://developers.google.com/oauthplayground を含む行を追加します。

6. [作成] をクリックします。

7. [クライアント ID] ページで、クライアント ID とクライアント シークレットをメモします。この 2 つは以降の手順で必要になります。

既存の Cloud プロジェクトがある場合は、上記のように承認済みリダイレクト URI を設定することで再利用できます。

トークンを生成する

注意: ブラウザでログインに使用している検索広告 360 ユーザーによって、生成する OAuth2 認証情報でアクセスできるアカウントが決まります。そのためこの手順は、シークレット ウィンドウで行うか、検索広告 360 アカウントにログインしていない状態で行うことをおすすめします。使用する認証情報が、クライアント ID とシークレットを入手した際にログインしたときとは別の認証情報である可能性があるためです。

1. OAuth2 Playground に移動します（このリンクを使用すると、一部のキー値は事前に入力されています）。

2. 右上の歯車アイコン をクリックし、[Use your own OAuth credentials] チェックボックスをオンにします（オンになっていない場合）。

3. 次の点をご確認ください。

   • [OAuth flow] が [Server-side] に設定されている。
   • [Access type] が [Offline] に設定されている（これにより、アクセス トークンだけでなく更新トークンも取得できます）。

4. 前述の手順で取得した OAuth2 クライアント ID と OAuth2 クライアント シークレットを入力します。

   

5. [Step 1 - Select & authorize APIs] で、リストから [Search Ads 360 Reporting API] をクリックし、スコープ https://www.googleapis.com/auth/doubleclicksearch を選択します。[Authorize APIs] をクリックします。

   

6. ログインを求められた場合は、アクセス権を付与して承認したいアカウントにログインします。または、画面右上に表示されているログイン中のユーザーが、認証情報を取得するクライアント アカウントまたは MCC アカウントと同一であることを確認します。

   クライアントの ID とシークレットを取得してから数分しか経っておらず、[Error: redirect_uri_mismatch] といったエラーが表示される場合は、適用した変更がまだ反映されていない可能性があります。ブラウザの「戻る」ボタンをクリックして数分待ってから、再度 [Authorize APIs] をクリックしてみてください。
   デベロッパーからアクセス権が付与されておらず、アプリが現在テスト中であるというエラーが表示された場合は、GCP プロジェクト内の OAuth 同意画面ページにアクセスし、次のいずれかを行います。

   • アプリケーションを公開する。

   • アプリのステータスは「テスト中」のままにして、自分をテストユーザーとして追加します。

7. アプリによる検索広告 360 キャンペーンの管理を有効にすることを確認するメッセージが表示されます。[同意する] をクリックして続行します。

8. [Step 2 - Exchange authorization code for tokens] タブに、[Authorization code] が表示されます。[Exchange authorization code for tokens] をクリックします。

   

9. 各設定が適切に完了すると、[Refresh token] と [Access token] の欄に値が入力されます（この値は [Step 2 - Exchange authorization code for tokens] タブを展開し直さないと表示されない場合があります）。

   

10. [Refresh token] の値とクライアント ID、クライアント シークレットをコピーして、使用するクライアント ライブラリの設定ファイルに貼り付けます。

11. Search Ads 360 Reporting API で OAuth 用のクライアント ライブラリを設定します。

クライアント ID から OAuth2 Playground を削除する

更新トークンを取得したら、OAuth2 Playground を承認済みのリダイレクト URI にする必要はなくなります。OAuth2 Playground を承認済み URI から削除する方法は以下のとおりです。

1. Google API コンソールの認証情報ページに移動します。

2. プロジェクトのメニューからプロジェクトを選択します。

3. 認証情報のページで、編集するクライアント ID の名前をクリックします。

4. [承認済みのリダイレクト URI] から https://developers.google.com/oauthplayground を削除します。リスト内に少なくとも 1 つ、リダイレクト URI を残しておく必要がある点にご注意ください。

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