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