OAuth2 Playground

OAuth2 認証情報の生成には、OAuth2 Playground を使う方法があります。OAuth2 Playground と Google Ads API コンソールを併用すれば、手動で 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 とクライアント シークレットをメモします。この 2 つは以降の手順で必要になります。

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

トークンを生成する

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

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

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

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

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

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