OAuth2 Playground

OAuth2 認証情報を生成する方法の 1 つは、OAuth2 Playground を使用することです。OAuth2 Playground と Google Ads API Console を組み合わせて使用すると、OAuth2 トークンを手動で作成できます。

OAuth2 Playground は、1 つのクライアント センター（MCC）アカウントまたは 1 人の Google 広告ユーザーのアカウントのみにアクセスする必要があるユーザーに適しています。複数のユーザーに認証情報の入力を求める必要がある場合は、検索広告 360 で 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] に設定されている。
    • [アクセスタイプ] が [オフライン] に設定されている（これにより、アクセス トークンだけでなく、更新トークンとアクセス トークンを取得できます）。

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

    playground settings

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

    authorize apis

  6. ログインを求められた場合は、アクセス権を付与して承認したいアカウントにログインします。それ以外の場合は、右上に表示されている現在のユーザーが、認証情報を取得するクライアント アカウントまたはマネージャー アカウントであることを確認します。

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

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

    playground authcode token

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

    playground refresh token

  10. 更新トークンを、クライアント ID とクライアント シークレットとともに、選択したクライアント ライブラリの構成ファイルにコピーします。

  11. Search Ads 360 Reporting API で OAuth 用のクライアント ライブラリを構成する。

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

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

  1. Google API Console の [認証情報] ページに移動します。

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

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

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

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