開発者トークンは、アプリを Google Ads API に接続するために使用する 22 文字の英数字文字列です。Google からトークンが割り当てられたら、Google 広告の MCC アカウントの [API センター] ページでトークンを表示したり、新しいトークンを作成したりできます。
各デベロッパー トークンにはアクセス権が割り当てられます。このアクセス権によって、トークンを使用して 1 日あたりに実行できる API 呼び出しの回数と、呼び出しを実行できる環境が制御されます。
本番環境アカウントに対して API 呼び出しを行うには、トークン申請プロセスで、開発者トークンの基本アクセス レベルまたは標準アクセス レベルをリクエストする必要があります。これらのアクセスレベルはテスト アカウントに対して呼び出しを行うために必要ではないため、演習を進めることができますが、このガイドを完了したら、ベーシック アクセスレベルを申請する方法を確認することをおすすめします。
新しいデベロッパー トークンが必要ですか？
新しいデベロッパー トークンに登録するかどうかは、いくつかの要因によって異なります。急増することがあります。
シナリオ |
次のステップ |
| 会社で Google Ads API を使用したことがなく、独自のアプリを開発したい | 新しいデベロッパー トークンに登録します。詳細 |
| お客様の会社が Google Ads API を現在使用しているか、過去に使用したことがある | 通常、Google は 1 社につき 1 つの開発者トークンを付与します。そのため、会社ですでに Google Ads API を使用している場合は、既存の開発者トークンを再利用する必要があります。詳細 |
| 会社ですでに Google Ads API を使用しているが、新しいプロダクトやツールも開発している | 既存のデベロッパー トークンを使用できないことが確実な場合は、申請書でユースケースを説明して、新しいトークンを申請できます。このガイドの残りの部分では、既存のデベロッパー トークンを使用できます。詳細 |
| 会社でサードパーティ製アプリを使用している | 開発者トークンが必要になるのは、独自のアプリを開発する場合のみです。サードパーティのアプリやサービスを使用する場合は、そのアプリのデベロッパーがアプリのデベロッパー トークンを取得する必要があります。ご自身のケースが不明な場合は、API コンプライアンス チームにお問い合わせください。 |
開発者トークンを申請する方法
デベロッパー トークンを申請する手順は 2 つあります。
ステップ 1: Google 広告のクライアント センター（MCC）アカウントを選択または作成する
Google 広告 MCC アカウントをすでにお持ちの場合は、トークンを申請する際にそのアカウントを選択します。この MCC アカウントが他のアカウントにまだリンクされていない場合は、アカウント階層のルートに配置することをおすすめします。そうすることで、トークンの審査プロセスが容易になり、後でアカウント管理が簡素化されます。
クライアント センター アカウントをお持ちでない場合は、ヘルプセンターの手順に沿って作成できます。
手順 2: Google 広告 API へのアクセスを申し込む
デベロッパー トークンの審査プロセスには時間がかかることがあります。詳細
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。メッセージが表示されたら、Google 広告の MCC アカウントにログインします。
API アクセス フォームに記入し、利用規約に同意します。
情報が正しく、会社のウェブサイトの URL が機能していることを確認します。ウェブサイトが公開されていない場合、Google は申請を処理できず、申請が不承認となる可能性があります。
提供する API の連絡先メールアドレスが、定期的にモニタリングされている受信トレイにつながっていることを確認します。Google の API コンプライアンス チームは、審査プロセス中にこのメールアドレスに連絡して、説明を求めることがあります。ご連絡が取れない場合、Google は申請手続きを続行しないことがあります。
API 連絡先メールアドレスは、API センターで編集できます。Google から重要なサービスに関するお知らせをお送りできるように、申請手続き後もこの情報を最新の状態に保ってください。
申請手続きが完了すると、API センターに開発者トークンが表示され、ステータスは [Pending Approval] になります。開発者トークンにテスト アカウント アクセス権が付与され、テスト アカウントに対して API 呼び出しを開始できるようになりました。
デベロッパートークンを取得したら、その値をメモしておきます。最初の API 呼び出しを行う際に必要になります。
MCC アカウントにログインしているかどうかを確認する
開発者トークンにアクセスするには、MCC アカウントにログインする必要があります。テスト用 MCC アカウントは使用できません。
MCC アカウントにログインしているかどうかを確認する手順は次のとおりです。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。
お客様のアカウントにログインしている場合は、[API センターは、クライアント センター（MCC）アカウントでのみご利用可能です。] というメッセージが表示されます。
右上隅に [テスト アカウント] が赤色で表示されている場合は、テスト マネージャーまたはテスト広告主です。
開発者トークンを確認する方法
開発者トークンがある場合は、Google 広告クライアント センター（MCC）アカウントの [API センター] ページで確認できます。