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] と [クライアント シークレット] をメモします。これらは次のステップで必要になります。

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

トークンを生成する

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

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

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

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

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

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

   

5. [ステップ 1 - API の選択と承認] で、リストから [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 token] をクリックします。

   

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 にする必要はありません。承認済みのリダイレクト URI のリストから削除するには:

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

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

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

4. 承認済みのリダイレクト URI から https://developers.google.com/oauthplayground を削除します。少なくとも 1 つのリダイレクト URI をそのまま残す必要があります。

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