Google Ads API へのアクセスを設定する

概要

Google Ads API を使用して Google 広告アカウントで API 呼び出しを行うには、開発者トークンをリクエストし、認証情報を取得する必要があります。詳しくは、クイック スタートガイドをご覧ください。

手動で行う場合の手順

Google Ads API を使用する手順は次のとおりです。

開発者トークンを取得する

Google 広告開発者トークンは、アプリを Google Ads API に接続します。

  1. 開発者トークンを取得するの手順に沿って操作します。
  2. 登録後、トークンは承認待ちになります。
  3. ソフトウェアが Google Ads API の利用規約（T&C）と最低限必要な機能（RMF）に準拠していることを確認してください。RMF は標準権限があるトークンでのみ必要です。

クライアント センター（MCC）アカウントのデベロッパー トークンは、Google 広告の管理画面の [ツールと設定] > [設定] > [API センター] でいつでも取得できます。

開発者トークンは、テスト MCC アカウントですぐに使用できます。本番用の Google 広告アカウントでは、承認済みの開発者トークンを使用する必要があります。

この API では、次のアクセスレベルが提供されます。

  • テスト
  • 基本
  • 標準

各レベルの詳細については、アクセス権と許可されている用途をご覧ください。

テスト アカウントを作成する

テスト アカウントは必須ではありませんが、テスト アカウントを使用すると、開発者トークンが承認される前に API 呼び出しを行い、コードをテストできます。こちらの手順に沿って、テスト アカウントとテスト キャンペーンを作成します。

クライアント ライブラリを選択する

Google Ads API のクライアント ライブラリのいずれかをダウンロードします。

コードサンプルとインストール手順は、各クライアント ライブラリに含まれています。

OAuth2 を設定する

OAuth2 を使用すると、アプリがアカウントの代わりに動作できます。このワークフローはデスクトップ アプリ用です。詳しくは、Google API Console プロジェクトを設定するをご覧ください。

OAuth2 と Google API を併用するには、OAuth2 クライアント ID とクライアント シークレットを作成します。

  1. クライアント センター（MCC）アカウントにログインした状態で、Google API Console の認証情報ページを開きます。
  2. [プロジェクト] プルダウンを開き、[新しいプロジェクト] を選択します。
  3. プロジェクトの名前を入力し、[作成] をクリックします。
  4. サイドバーで [OAuth 同意画面] をクリックし、必要な情報を入力して、[保存して続行] をクリックします。詳しくは、OAuth ガイドをご覧ください。
  5. サイドバーで、[認証情報] > [認証情報を作成] > [OAuth クライアント ID] をクリックし、[デスクトップ アプリ] を選択します。
  6. クライアントの名前を入力し、[作成] をクリックします。

これにより、クライアント ID とクライアント シークレットが生成されます。

更新トークンを取得する

Google API にアクセスするには、更新トークンも必要です。

更新トークンを取得するには、選択したクライアント ライブラリの手順に沿って操作します。手順はプログラミング言語ごとに異なります。各ライブラリの認証サンプルをご覧ください。

最初の API 呼び出しを実行する

Google Ads API の最初の呼び出しのチュートリアルに沿って、簡単な呼び出しを行います。

自動で行う場合の手順

このプロセスでは使用できません。