開発者トークンは、アプリを Google Ads API に接続するために使用された 22 文字の英数字文字列です。デベロッパー トークンは 2026 年 9 月 9 日に廃止されました。このガイドでは、変更の概要と、この移行に関するよくある質問をまとめて、既存のデベロッパーを支援します。
変更内容
デベロッパー トークンのサポート終了の一環として、Google Ads API のオンボーディング エクスペリエンスと API アクセス管理にいくつかの変更を加えました。このセクションでは、主な変更点について説明します。
API アクセスレベルは Google Cloud プロジェクトに関連付けられている
デベロッパー トークンは 2026 年 9 月 9 日にサポートが終了します。最近の API のご利用状況に基づき、現在有効な開発者トークンのアクセスレベルが Google Cloud プロジェクトに自動的に移行されました。API 呼び出しのヘッダーに開発者トークンを引き続き含めることはできますが、これは任意であり、API サーバーによって無視されます。既存のコードは変更なしで引き続き機能します。API アクセスレベルは、OAuth 認証情報の生成に使用した Google Cloud プロジェクトによって決定されるようになりました。
- アプリがユーザー認証ワークフローを使用している場合、これは OAuth クライアント ID とシークレットを所有するプロジェクトです。
- サービス アカウント ワークフローを使用している場合は、サービス アカウントを所有するプロジェクトです。
Google Ads API の新しい登録手続き
Google 広告のクライアント センター（MCC）アカウントがなくても、Google Cloud コンソールから直接 Google Ads API へのアクセスに登録できるようになりました。これらのプロセスは Google Cloud コンソールに移行されているため、Google 広告クライアント センター（MCC）アカウントの API センターのページから開発者トークンに登録したり、API センターのページから API アクセスを申請したりしないでください。API センターのページから開始されたプロセスは処理されません。
新しい API アクセス管理エクスペリエンス
Google 広告のクライアント センター（MCC）アカウントの API センターのページで、API アクセスの申請や API アクセスレベルの管理など、新規登録と API アクセス管理のすべての機能が廃止されました。これらの機能は、Google Cloud コンソールの Google Ads API の概要ページでご利用いただけるようになりました。
API センターのページには引き続きアクセスして、過去のデベロッパーの詳細情報を確認できます。このページは今後完全に廃止されます。
新しいエラーコード
Google Ads API のバージョン v25 では、テストアクセス権限のある Google Cloud プロジェクトを使用して本番環境アカウントを呼び出そうとすると、AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION エラーがスローされます。古い API バージョンでは、代わりに AuthorizationError.ACTION_NOT_PERMITTED エラーがスローされます。このエラーが発生した場合は、Google Cloud プロジェクトの Google Ads API の概要ページに移動して、Explorer へのアクセスを申請してください。
Basic アクセスと標準権限にはブランドの確認が必要です
新しい Basic アクセス アプリケーションと標準権限アプリケーションの場合は、Google Cloud クラウド プロジェクトのブランドの確認を完了する必要があります。既存のアクセス権所有者は、ブランドの確認を完了する必要はありませんが、完了することが推奨されます。
ベーシック アクセスの申請は自動化されており、ブランドの確認と送信後数分以内に審査されます。
このプロセスの更新により、この移行の一環として、保留中のすべてのベーシック アクセス申請が閉じられます。影響を受ける申請者には、詳細を記載したメールが届きます。Google Ads API の概要ページから基本アクセスを再度申請してください。
新しい API の連絡先メールアドレス
API センターページの廃止に向けて、Google Cloud プロジェクトのオーナーと編集者のユーザーのリストを、管理および必須のコンプライアンスに関する通知の唯一のチャネルとして使用するように移行します。移行をスムーズに進めるため、サービスに関する重要なお知らせ（MSA）は、API Center に記載されているメールアドレスに引き続き一時的に送信されます。コミュニケーション チャネルの移行が完了次第、改めてお知らせいたします。
既存のデベロッパーの場合の対処方法
Google Cloud プロジェクトの API アクセスレベルを確認する: 既存のデベロッパーの方は、Google Cloud プロジェクトの Google Ads API の概要ページで、既存の開発者トークンと同じ API アクセスレベルが設定されていることを確認してください。このガイドの手順に沿って、見つかった不一致に対処してください。
API の連絡先メールアドレスを確認する: Google Cloud プロジェクトの IAM（Identity and Access Management）ページにアクセスします。有効な広告デベロッパーとアカウント マネージャーに、Google Cloud プロジェクトで適切なオーナーまたは編集者のロールが割り当てられていることを確認します。今後、Google Ads API に変更があった場合は、これらのメールアドレスにサービスに関するお知らせ（MSA）をお送りします。当面の間は、API センターに登録されている連絡先メールアドレスに MSA を引き続き送信します。このプロセスが更新されるたびに、お知らせいたします。
アプリのコードを修正する: API 呼び出しの一部として開発者トークンを送信しないよう、アプリを更新することをおすすめします。開発者トークンを設定せずに API 呼び出しを行えるよう、クライアント ライブラリ、Google 広告 MCP サーバー、Google Ads API Developer Assistant の更新版を公開しました。Google Ads API の今後のメジャー バージョンでは、API 呼び出しで開発者トークンが拒否されるようになります。アプリでこれらのライブラリを使用している場合は、最新バージョンを使用するようにアプリの依存関係を更新してください。
さらにサポートが必要な場合や、ご不明な点がある場合は、Google Ads API サポートにお問い合わせください。
既知の問題
このセクションでは、デベロッパー トークンのサポート終了に関連する既知の問題について説明します。
ブランドの確認を完了しても、ユーザーに探索ユーザー アクセス権または Basic アクセス権が付与されない
ブランド認証済みのプロジェクトをお持ちのお客様が、ベーシック アクセスを申請する際に拒否される問題が発生しています。ユーザーには「ベーシック アクセスには、OAuth ブランド プロファイルが正常に確認されている必要があります。プロジェクトのブランド確認が完了していないため、お申し込みを承認できませんでした。」同様に、Explorer アクセスに登録した一部のユーザーも、「現時点では、Google 広告 API のポリシーと利用規約に基づく本番環境アカウントへの直接アクセスに必要な資格要件を満たしていないため、お客様の Google Cloud プロジェクトに Explorer アクセス権を付与することはできません」という拒否メールが届き、登録が拒否されています。
根本的な原因
Google Cloud プロジェクトが Google Cloud 無料トライアル プログラムの対象であるか、請求先アカウントが一時停止または無効になっている可能性があります。
適格性確認を完了する方法
Google Cloud のお支払いステータスを確認します。請求先プロジェクトが「無料トライアル アカウント」と表示されている場合や、一時停止または無効の状態になっている場合は、この問題の影響を受けています。
ステータス
この問題については、原因を特定し、修正に取り組んでおります。
一時的な回避策
この問題を解決するには、いくつかの回避策があります。ユースケースに最適なオプションを選択します。
Google Cloud プロジェクトを有料階層にアップグレードする
Google Cloud プロジェクトを有料階層にアップグレードします。数分待ってから、ベーシック アクセスの申請をもう一度お試しください。
Google Cloud プロジェクトの課金を削除する
Google Cloud プロジェクトで他のサービスが実行されていない場合は、Google Cloud プロジェクトの課金を削除します。数分待ってから、ベーシック アクセスの申請をもう一度お試しください。
別の Google Cloud プロジェクトを使用する
ブランド認証済みの別の Google Cloud プロジェクトがある場合は、そのプロジェクトを使用してベーシック アクセスの申請を行ってください。
新しく承認されたベーシックまたはエクスプローラ アクセスレベルのプロジェクトで AUTHORIZATION_ERROR が発生する
最近 Google Cloud プロジェクトのアクセスレベルを承認済みの Basic または Explorer アクセスレベルにアップグレードした一部のユーザーが、本番環境アカウントに対して Google Ads API 呼び出しを行う際に AUTHORIZATION_ERROR を受け取るという問題が確認されています。
根本的な原因
一部のプロジェクトで、Google Cloud コンソールから完了した API アクセスレベルのアップグレードが Google Ads API で反映されません。
適格性確認を完了する方法
次のすべての条件に該当する場合、この問題の影響を受けます。
- テスト アクセスレベルの開発者トークンがある。
- 2026 年 9 月 9 日より前に、Google Cloud プロジェクトとデベロッパー トークンを使用して Google Ads API の API 呼び出しを行った。
- 2026 年 9 月 9 日以降に、Google Cloud プロジェクトのアクセスレベルを Explorer、Basic、Standard にアップグレードした。
- 本番環境アカウントへの API 呼び出しが
AUTHORIZATION_ERRORで失敗します。テスト アカウントへの API 呼び出しが成功する。
ステータス
この問題の修正は完了しており、現在サーバーへのロールアウトに取り組んでいます。修正がリリースされると、API 呼び出しが再び機能し始めます。
一時的な回避策
新しい Google Cloud プロジェクトを使用して、Explorer へのアクセスを申請できます。
よくある質問
API アクセスレベルはどうなりますか？
Google Ads API では、API アクセスレベルが引き続き適用されます。ただし、これらの権限はデベロッパー トークンではなく、Google Cloud コンソール プロジェクトに付与されるようになりました。API 呼び出しを行う場合、API アクセスレベルは、OAuth 認証情報の生成に使用した Google Cloud プロジェクトによって決定されるようになりました。
- アプリがユーザー認証ワークフローを使用している場合、これは OAuth クライアント ID とシークレットを所有するプロジェクトです。
- サービス アカウント ワークフローを使用する場合は、サービス アカウントを所有するプロジェクトです。
API アクセスレベルの転送対象となるプロジェクトはどのように特定されましたか？
2026 年 9 月 9 日より前に承認済みのデベロッパー トークンをお持ちの場合、そのアクセスレベルは次のように Google Cloud プロジェクトに転送されています。
- 過去 90 日間の API 呼び出しログを調査し、承認済みの開発者トークンを使用して API 呼び出しを行った Cloud プロジェクトを特定しました。
- 特定されたすべての Cloud プロジェクトに、デベロッパー トークンの API アクセスレベルが割り当てられました。
この変更後、さまざまなアクセスレベルを持つ複数の Cloud プロジェクトを作成できますか？
はい。API アクセスレベルが異なる複数の Google Cloud プロジェクトを作成できます。たとえば、Basic アクセス権を持つ Google Cloud プロジェクトと、Standard アクセス権を持つ別の Google Cloud プロジェクトを作成できます。
例
たとえば、次の詳細情報を持つ 4 つのデベロッパー トークンと 6 つの Cloud プロジェクトがあるとします。
- 開発者トークン 1:
abcdefghijkl1234567890には標準権限が付与されています。プロジェクト ID1234567890、5678912345、45678912345で使用されています。 - 開発者トークン 2:
xyzabcdefghi6789012345には基本アクセス権があります。プロジェクト ID1231235678で使用されています。 - デベロッパー トークン 3:
asdfgflkjhjz7654321012には基本アクセス権がありますが、API 呼び出しに使用されたことはありません。最近承認されました。 - デベロッパー トークン 4:
qwertypoiuyu6543298790は標準アクセス権を持っていますが、過去 90 日間使用されていません。プロジェクト ID9876564900は、過去にこの開発者トークンで使用されています。 - Cloud プロジェクト: Cloud プロジェクト ID:
7171234567は、API 呼び出しを行うためにデベロッパー トークンで使用されたことがありません。
API のアクセスレベルは、開発者トークンから Google Cloud プロジェクトに次のように移行されます。
| 開発者トークン | プロジェクト ID | アクセスレベル | 説明 |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
標準アクセス | 開発者トークンとプロジェクト ID は相互に関連付けられています。 |
abcdefghijkl1234567890 |
5678912345 |
標準アクセス | 開発者トークンとプロジェクト ID は相互に関連付けられています。 |
abcdefghijkl1234567890 |
45678912345 |
標準アクセス | 開発者トークンとプロジェクト ID は相互に関連付けられています。 |
xyzabcdefghi6789012345 |
1231235678 |
基本アクセス | 開発者トークンとプロジェクト ID は相互に関連付けられています。 |
asdfgflkjhjz7654321012 |
-- |
-- |
デベロッパー トークンの API アクセスは、API 呼び出しに使用されたことがないため、どのプロジェクトにも転送されませんでした。 |
qwertypoiuyu6543298790 |
9876564900 |
アクセスをテストする | 90 日間使用されなかったため、デベロッパー トークンの API アクセス権が取り消されました。プロジェクトの API アクセスレベルはデフォルトでテストアクセスに設定されています。 |
-- |
7171234567 |
アクセスをテストする | これは、開発者トークンで使用されていない新しいプロジェクトです。プロジェクトの API アクセスレベルはデフォルトでテストアクセスに設定されています。 |
承認済みの開発者トークンが複数あります。API アクセスレベルを転送するプロジェクトを選択してください。
承認済みの各開発者トークンのアクセスレベルは、その開発者トークンに関連付けられている Google Cloud プロジェクトに移行されます。例をご覧ください。
複数の Google Cloud プロジェクトを使用しています。どのプロジェクトの API アクセスレベルを転送しますか？
過去 90 日間に承認済みの開発者トークンで複数の Google Cloud プロジェクトを使用した場合、それらのすべてのプロジェクトに、開発者トークンと同じ API アクセスレベルが付与されます。例をご覧ください。
使用しなくなったプロジェクトに API アクセスレベルが割り当てられています。この問題を解決するにはどうすればよいですか？
Google 広告 API へのアクセスが、使用しなくなった Google Cloud プロジェクトに割り当てられている場合は、お客様側で追加の対応は必要ありません。90 日間使用されていないプロジェクトの API アクセス権は取り消されます。
Google Cloud プロジェクトに API アクセスレベルが割り当てられていません。この問題を解決するにはどうすればよいですか？
Google Cloud プロジェクトに開発者トークンのアクセスレベルが継承されなかったのは、開発者トークンとクラウド プロジェクトを使用して API 呼び出しを行ったことがないか、開発者トークンの API アクセスが最近非アクティブ状態のために期限切れになったことが原因である可能性があります。この問題を解決するには、Google Ads API の概要ページから、そのプロジェクトに適した API アクセスレベルを申請してください。例をご覧ください。
プロジェクトの API アクセスレベルはどこで確認できますか？
Google Cloud プロジェクトの API アクセスレベルは、Google Ads API の概要ページで確認できます。
API アクセスレベルを上げるにはどうすればよいですか？
Google Cloud プロジェクトの API アクセスレベルの引き上げは、Google Ads API の概要ページから申請できます。
保留中の API アクセス申請はどうなりますか？
2026 年 9 月 9 日より前に Google 広告クライアント センター（MCC）アカウントの API センターから開始された、保留中のベーシック アクセスの申請はすべて終了します。Google Cloud プロジェクトの Google Ads API の概要ページから、ベーシック アクセスを再度申請してください。この変更の影響を受ける場合は、必要な手順を記載したメールが届きます。
2026 年 9 月 9 日時点で Google 広告クライアント センター（MCC）アカウントの API センターから開始された標準権限の申請は、通常どおり審査されます。承認されると、デベロッパー トークンに関連付けられている Google Cloud プロジェクトに標準権限が付与されます。
承認済みのデベロッパー トークンを新しい Google Cloud プロジェクトに再関連付けることはできますか？
これまで、Google Ads API チームは、開発者トークンを新しい Google Cloud プロジェクトに再関連付けることをケースバイケースでサポートしていました。デベロッパー トークンが廃止されたため、2026 年 9 月 9 日をもってサポートが終了しました。新しい Google Cloud プロジェクトを使用する必要がある場合は、Google Cloud プロジェクトの Google Ads API の概要ページから適切な API アクセスを申請する必要があります。
承認済みの開発者トークンがありますが、一度も使用していません。この開発者トークンを使用できますか？
いいえ、この開発者トークンは使用できません。次の 2 つの可能性があります。
非アクティブ状態が続くと、開発者トークンのアクセス権が取り消される可能性があります。Google のポリシーに準拠して、90 日間連続で使用されていない API トークンは、Google によって取り消されることがあります。開発者トークンをしばらく使用していない場合は、非アクティブ状態が原因でアクセスレベルが取り消されている可能性があります。この場合は、Google Ads API の概要ページから Google Cloud プロジェクトの API アクセスを再度申請してください。例をご覧ください。
開発者トークンが最近承認されたが、2026 年 9 月 9 日より前に使用したことがない場合: 承認済みの開発者トークンを 2026 年 9 月 9 日より前に Google Cloud プロジェクトで使用したことがないため、アクセスレベルが Cloud プロジェクトに転送されませんでした。そのため、デベロッパー トークンは使用できなくなります。このデベロッパー トークンを使用して本番環境アカウントに API 呼び出しを行おうとすると、
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONエラーがスローされます。このエラーを解決するには、Google Cloud プロジェクトの Google Ads API の概要ページから適切な API アクセスを申請してください。例をご覧ください。
どちらの場合も、Explorer アクセスと Basic アクセスレベルの申請を行い、自動審査を受けることができます。審査プロセスを完了するために Google のコンプライアンス チームと連携する必要はなくなりました。標準権限が必要な場合は、手動による審査が必要です。ただし、承認済みの開発者トークンの詳細情報を共有することで、コンプライアンス チームが新しい標準権限の申請を適切に審査できるようになります。
API リクエストの一部としてデベロッパー トークンを送信するのを停止できますか？
はい。API リクエストの一部として開発者トークンを送信しないようにすることができます。クライアント ライブラリを使用している場合は、最新バージョンにアップグレードする必要がある場合があります。ライブラリの変更ログを確認して、開発者トークンを指定せずに API 呼び出しを行えるかどうかを確認します。
Cloud Managed Access Level のパイロット プログラムに参加していました。どのような影響がありますか？
Cloud 管理アクセスレベルのパイロット プログラムは、Google Cloud デベロッパーが API リクエストの一部として開発者トークンを送信せずに API 呼び出しを行う方法として導入されました。デベロッパー トークンが廃止されたため、このプログラムは終了します。
有効な開発者トークンのアクセスレベルは Google Cloud プロジェクトに転送されているため、既存のコードは変更なしで引き続き機能します。新しい Google Cloud プロジェクトを使用する必要がある場合は、Google Cloud プロジェクトの Google Ads API の概要ページから API アクセスを申請する必要があります。
開発者トークンが許可リストに含まれていた。どのような影響がありますか？
Google は、一部のデベロッパーに試験運用版の機能へのアクセス権を付与するパイロット プログラムを実施する場合があります。これらの機能へのアクセスは、開発者トークンを許可リストに追加することで提供される場合があります。このような試験運用プログラムに参加されていた場合は、お客様側で特別な対応をしていただく必要はありません。
すべての試験運用プログラムを更新し、許可リスト登録メカニズムとしてデベロッパー トークンではなく Google Cloud プロジェクトを使用するようにしました。また、デベロッパー トークンの許可リスト登録ステータスを関連付けられた Google Cloud プロジェクトに移行しました。既存のコードは変更なしで引き続き機能します。問題が解決しない場合は、パイロット プログラムに登録した Google アカウント マネージャーにお問い合わせください。
承認済みのデベロッパー トークンがあり、新しい Google Cloud プロジェクトで使用したい。これは許可されていますか？
いいえ。承認済みのデベロッパートークンで新しい Google Cloud プロジェクトを使用することはできません。2026 年 9 月 9 日より前に、承認済みのデベロッパー トークンを新しい Google Cloud プロジェクトで使用したことがないため、そのアクセスレベルは Cloud プロジェクトに転送されませんでした。開発者トークンは API アクセスレベルの決定に使用されなくなったため、この開発者トークンを使用して API 呼び出しを行うと、CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION エラーがスローされます。このエラーを解決するには、Google Cloud プロジェクトの Google Ads API の概要ページから適切な API アクセスを申請してください。例をご覧ください。
開発者トークンが外部に漏洩しました。開発者トークンをリセットする必要がありますか？
いいえ。この場合はデベロッパー トークンをリセットする必要はありません。開発者トークンの API アクセスレベルが Google Cloud プロジェクトに移行されたため、承認されていないユーザーが自分の Google Cloud プロジェクトで開発者トークンを使用することはできなくなります。
API Center はどうなりますか？
Google 広告クライアント センター（MCC）アカウント内の既存の API センター ページは非推奨となり、近い将来削除される予定です。開発者トークンをすでにお持ちの場合は、Google 広告の MCC アカウントにログインして詳細を表示できます。ただし、これらは参考用としてのみ提供されます。このページから、より高い API アクセスレベルを申請するなど、開発者トークンのアクセスレベルに関連するタスクは行わないでください。
API アクセスレベルの引き上げを申請する必要がある場合は、Google Cloud プロジェクトの Google Ads API の概要ページから申請してください。
Google Ads API を使用するには、Google 広告クライアント センター（MCC）アカウントがまだ必要ですか？
Google Ads API を使用する際に、Google 広告クライアント センター（MCC）アカウントは不要になりました。API を使用して複数のアカウントをリンクして管理する必要がある場合にのみ、クライアント センター（MCC）アカウントが必要です。
私は新しいデベロッパーです。Google Ads API に登録するにはどうすればよいですか？
スタートガイドの手順に沿って、Google Ads API に登録します。Google 広告クライアント センター（MCC）アカウントの API センターから開発者トークンを登録しないでください。これらの申請は処理されません。API センターは近い将来に廃止される予定です。
API アクセスレベルを管理するために必要な IAM 権限は何ですか？
Google Ads API のアクセスレベルを管理するには、Google Cloud プロジェクトに対する割り当て管理権限が必要です。必要な権限は、オーナー、編集者、割り当て管理者、Service Usage 管理者のロールにデフォルトで含まれています。詳細については、割り当て権限のドキュメントをご覧ください。
割り当てられているロールを確認するには、Google Cloud プロジェクトの IAM ページを確認します。Google Cloud プロジェクトの管理者と協力して、Google Cloud プロジェクトに必要な IAM ロールを付与します。