開発者トークンは、アプリを Google Ads API に接続するために使用する 22 文字の英数字文字列です。API キーは、Google 広告クライアント センター（MCC）アカウントの API センター ページで登録すると取得できます。API 呼び出しを行うたびに、developer-token http ヘッダーまたは gRPC ヘッダーを設定して、リクエストの一部としてデベロッパー トークンを送信します。
各デベロッパー トークンにはアクセス権が割り当てられます。このアクセス権によって、トークンを使用して 1 日あたりに行うことができる API 呼び出しの回数と、呼び出しを行うことができる環境が制御されます。デベロッパー トークンに登録すると、デフォルトで [テストアクセス] レベルになります。これにより、テスト アカウントに対してのみ 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 呼び出しを開始できるようになりました。
MCC アカウントにログインしているかどうかを確認する
開発者トークンにアクセスするには、MCC アカウントにログインする必要があります。テスト用 MCC アカウントは使用できません。
MCC アカウントにログインしているかどうかを確認する手順は次のとおりです。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。
お客様のアカウントにログインしている場合は、[API センターは、クライアント センター（MCC）アカウントでのみご利用可能です。] というメッセージが表示されます。
右上隅に [テスト アカウント] が赤色で表示されている場合は、テスト マネージャーまたはテスト広告主のアカウントです。
開発者トークンを確認する方法
開発者トークンがある場合は、Google 広告クライアント センター（MCC）アカウントの [API センター] ページで確認できます。