概要
Google Ads API を使用して Google 広告アカウントで API 呼び出しを行うには、開発者トークンをリクエストし、認証情報を取得する必要があります。詳しくは、クイックスタート ガイドをご覧ください。
手動で行う場合の手順
Google Ads API を使用する手順は次のとおりです。
開発者トークンを取得する
Google 広告開発者トークンは、アプリを Google Ads API に接続します。
- 開発者トークンを取得するの手順に沿って操作します。
- 登録後、トークンは承認待ちになります。
- ソフトウェアが Google Ads API の利用規約（T&C）と最低限必要な機能（RMF）を遵守していることを確認してください。RMF は、標準権限があるトークンにのみ必要です。
クライアント センター（MCC）アカウントのデベロッパー トークンは、Google 広告の UI の [管理 > API センター] でいつでも取得できます。
テスト用クライアント センター（MCC）アカウントでは、デベロッパー トークンをすぐに使用できます。デベロッパー トークンを本番環境の Google 広告アカウントで使用するには、事前に承認を受ける必要があります。
API では、次のアクセスレベルが提供されます。
- テスト
- 基本
- 標準
各レベルの詳細については、アクセスレベルと許容される使用方法をご覧ください。
テスト アカウントを作成する
テスト アカウントは必須ではありませんが、テスト アカウントを使用すると、デベロッパー トークンが承認される前に API 呼び出しを行ってコードをテストできます。テスト用アカウントとテスト用キャンペーンを作成するには、こちらの手順に沿って操作します。
クライアント ライブラリを選択する
Google Ads API のクライアント ライブラリのいずれかをダウンロードします。
各クライアント ライブラリには、コードサンプルとインストール手順が含まれています。
OAuth2 を設定する
OAuth2 を使用すると、アプリがアカウントに代わって操作できるようになります。このワークフローはデスクトップ アプリ用です。詳細については、Google API Console プロジェクトを構成するをご覧ください。
Google API で OAuth2 を使用するには、OAuth2 クライアント ID とクライアント シークレットを作成します。
- マネージャー アカウントにログインした状態で、Google API Console の認証情報ページを開きます。
- [プロジェクト] プルダウンを開き、[新しいプロジェクト] を選択します。
- プロジェクトの名前を入力して、[作成] をクリックします。
- サイドバーで [OAuth 同意画面] をクリックし、必要な情報を入力して、[保存して次へ] をクリックします。詳しくは、OAuth ガイドをご覧ください。
- サイドバーで、[認証情報] > [認証情報を作成] > [OAuth クライアント ID] をクリックし、[デスクトップ アプリ] を選択します。
- クライアントの名前を入力し、[作成] をクリックします。
これにより、クライアント ID とクライアント シークレットが生成されます。
更新トークンを取得する
Google API にアクセスするには、更新トークンも必要です。
更新トークンを取得するには、選択したクライアント ライブラリの手順に沿って操作します。手順はプログラミング言語ごとに異なります。各ライブラリの認証サンプルをご覧ください。
最初の API 呼び出しを実行する
Google Ads API の最初の呼び出しに関するチュートリアルに沿って、簡単な呼び出しを行います。
自動で行う場合の手順
このプロセスでは使用できません。