OAuth2 Playground

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

OAuth2 Playground は、1 つのクライアント センター(MCC)アカウントまたは 1 人の Google 広告ユーザーのアカウントのみにアクセスする必要があるユーザーに適しています。複数のユーザーに認証情報の入力を求める必要がある場合は、Google Ads API で OAuth のクライアント ライブラリを設定することをおすすめします。

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

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

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

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

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

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

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

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

  7. [クライアント ID] ページで、[クライアント ID] と [クライアント シークレット] をメモします。これらは次のステップで必要になります。

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

トークンを生成する

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

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

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

    • [OAuth flow] が [Server-side] に設定されている。
    • [Access type] が [Offline] に設定されている(これにより、アクセス トークンだけでなく、更新トークンとアクセス トークンの両方を取得できます)。
  4. 前述の手順で取得した OAuth2 クライアント IDOAuth2 クライアント シークレットを入力します。

    playground settings

  5. [Step 1 - Select & Authorization APIs] というセクションで、リストから [Google Ads API] をクリックし、そのスコープ(https://www.googleapis.com/auth/adwords)を選択します。[Authorize APIs] をクリックします。

    authorize apis

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

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

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

    playground authcode token

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

    playground refresh token

  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 を削除します。リダイレクト URI を少なくとも 1 つ残しておく必要があるので注意してください。

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