OAuth2 Playground

OAuth2 認証情報の生成には、OAuth2 Playground を使う方法もあります。OAuth2 Playground と Google API Console を併用すれば、手動で OAuth2 トークンを生成できます。

OAuth2 Playground は、1 つのクライアント センター（MCC）アカウントまたは 1 人の Google 広告ユーザーのアカウントのみにアクセスする必要があるユーザーに適しています。複数のユーザーに認証情報をリクエストする場合は、Google Ads API で 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 プロジェクトがある場合は、ステップ 5 で説明したように承認済みリダイレクト URI を設定することで再利用できます。

トークンを生成する

警告: ブラウザでログインに使用している Google アカウントによって、生成する OAuth2 認証情報でアクセスできる Google 広告アカウントが決まります。そのためこの手順は、シークレット ウィンドウで行うか、Google アカウントにログインしていない状態で行うことをおすすめします。使用する認証情報が、クライアント 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] で、リストから [Google Ads API] をクリックし、スコープ https://www.googleapis.com/auth/adwords を選択します。[Authorize APIs] をクリックします。

   

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

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

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

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

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

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. Google Ads 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. [保存] をクリックします。