開発者トークンは、アプリを Google Ads API に接続するために使用する 22 文字の英数字文字列です。API キーは、Google 広告クライアント センター（MCC）アカウントの API センター ページで登録すると取得できます。API 呼び出しを行うたびに、developer-token http または gRPC ヘッダーを設定して、リクエストの一部としてデベロッパー トークンを送信します。
各デベロッパー トークンにはアクセス権が割り当てられます。このアクセス権によって、トークンを使用して 1 日あたりに行うことができる API 呼び出しの数と、呼び出しを行うことができる環境が制御されます。
開発者トークンに登録すると、デフォルトでエクスプローラ アクセス レベルが付与されることがあります。これにより、本番環境アカウントに対して呼び出しを行うことができますが、特定の制限があります。デベロッパー トークンの申請を自動的に審査できない場合、デベロッパー トークンにテスト アカウント アクセス レベルを付与することがあります。これにより、テスト アカウントに対してのみ API 呼び出しを行うことができます。エクスプローラ アカウントとテスト アカウントのアクセスレベルの制限を解除するには、デベロッパー トークンの基本アクセス レベルまたは標準アクセス レベルをリクエストする必要があります。デベロッパー トークンの申請が審査され承認されると、デベロッパー トークンに適切なアクセスレベルが付与されます。
新しいデベロッパー トークンが必要ですか？
新しいデベロッパー トークンに登録するかどうかは、いくつかの要因によって異なります。急増することがあります。
シナリオ |
次のステップ |
| 貴社は Google Ads API を使用したことがなく、独自のアプリを開発したい | 新しいデベロッパー トークンに登録します。詳細 |
| お客様の会社が Google Ads API を現在使用しているか、過去に使用したことがある | 通常、Google は 1 社につき 1 つの開発者トークンを付与します。そのため、会社ですでに Google Ads API を使用している場合は、既存の開発者トークンを再利用する必要があります。詳細 |
| 会社ですでに Google Ads API を使用しているが、新しいプロダクトやツールも開発している | 既存のデベロッパー トークンを使用できないことが確実な場合は、申請書でユースケースを説明して、新しいトークンを申請できます。このガイドの残りの部分では、既存のデベロッパー トークンを使用できます。詳細 |
| 会社でサードパーティ製アプリを使用している | 開発者トークンが必要になるのは、独自のアプリを開発する場合のみです。サードパーティのアプリやサービスを使用する場合は、そのアプリのデベロッパーがアプリのデベロッパー トークンを取得する必要があります。ご自身のケースが不明な場合は、API コンプライアンス チームにお問い合わせください。 |
開発者トークンを申請できるのは誰ですか？
開発者トークンは、企業と個人のデベロッパーの両方が申請できます。次の表に、デベロッパー トークンに登録する際に提供する必要がある情報の概要を示します。
| お客様が | 続いて、次のデベロッパーの詳細情報を指定します。 | その他の情報 |
|---|---|---|
| 会社またはプロダクト チームを代表するデベロッパー | 会社名と会社の URL | 通常、Google は 1 社につき 1 つのデベロッパー トークンを付与しますが、個別のツールについては、ケースバイケースで個別のデベロッパー トークンを承認します。 |
| 会社を代表していない個人のデベロッパー | 会社名を Individual として指定します。会社の URL の代わりに、GitHub プロフィール URL や LinkedIn プロフィール URL などの代替 URL を指定できます。 |
オンラインでのプレゼンスが必要であり、Google Ads API で何を行う予定かを Google が評価するのに役立つ URL を Google に提供する必要があります。test.com や example.com などの一般的な URL は受け付けられません。 |
開発者トークンを申請する方法
デベロッパー トークンを申請する手順は 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 センターに次のいずれかの結果とともにデベロッパー トークンが表示されます。
- 開発者トークンのアクセスレベルが [エクスプローラ] で、ステータスが [承認済み] である。つまり、Google は Explorer アクセスレベルのデベロッパー トークン申請を自動的に審査して承認しました。本番環境アカウントまたはテスト アカウントに対して API 呼び出しを開始できます。
- 開発者トークンのステータスが「承認待ち」で、テスト アカウントへのアクセス レベルが付与されている。これは、Google がエクスプローラ アクセス レベルのデベロッパー トークン申請を自動的に審査して承認できなかったことを意味します。テスト アカウントに対して API 呼び出しを開始できます。このガイドを完了したら、基本アクセスレベルを申請する方法をご確認ください。
Google 広告の MCC アカウントにログインしているかどうかを確認する
開発者トークンにアクセスするには、Google 広告の MCC アカウントにログインする必要があります。Google 広告のテスト用 MCC アカウントは使用できません。
Google 広告の MCC アカウントにログインしているかどうかを確認する手順は次のとおりです。
ウェブブラウザで https://ads.google.com/aw/apicenter に移動します。
お客様のアカウントにログインしている場合は、[API センターは、クライアント センター（MCC）アカウントでのみご利用可能です。] というメッセージが表示されます。
右上に [テスト アカウント] が赤字で表示されている場合は、アカウントがテスト マネージャーまたはテスト広告主です。
開発者トークンを確認する方法
開発者トークンがある場合は、Google 広告クライアント センター（MCC）アカウントの [API センター] ページで確認できます。