開発者トークンは、アプリを 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 へのアクセスに登録できます。これらのプロセスは Google Cloud コンソールに移行されているため、Google 広告クライアント センター（MCC）アカウントの API センターのページから開発者トークンに登録したり、API センターのページから API アクセスを申請したりしないでください。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 プロジェクトのオーナーと編集者のリストを、管理および必須のコンプライアンスに関する通知の唯一のチャネルとして使用するように移行します。移行をスムーズに進めるため、サービスに関する重要なお知らせ（MSA）は、API センターに記載されているメールアドレスに一時的に引き続き送信されます。コミュニケーション チャネルの移行が完了次第、改めてお知らせいたします。
既存のデベロッパーの場合の対処方法
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 呼び出しの一部として開発者トークンを送信しないよう、アプリを更新することをおすすめします。クライアント ライブラリ、Google 広告 MCP サーバー、Google 広告 API デベロッパー アシスタントの更新版が公開されました。これにより、デベロッパー トークンを設定せずに API 呼び出しを行うことができます。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 プロジェクトがある場合は、そのプロジェクトを使用してベーシック アクセスを申請してください。
新しく承認されたベーシック アクセスレベルまたはエクスプローラ アクセスレベルを持つプロジェクトで AUTHORIZATION_ERROR が発生する
2026 年 9 月 9 日以降に Google Cloud プロジェクトのアクセスレベルを承認済みのベーシック アクセスレベルまたはエクスプローラー アクセスレベルにアップグレードした一部のユーザーが、本番環境アカウントに対して 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 アクセスレベルに関するよくある質問とその回答を紹介します。
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 日以上前にこのデベロッパー トークンで使用されました。 - クラウド プロジェクト: クラウド プロジェクト 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 Ads 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 アクセスを申請してください。例をご覧ください。
どちらの場合も、Explorer アクセスと Basic アクセスレベルの申請を行い、自動的に審査を受けることができます。審査プロセスを完了するために 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 アクセスレベルの決定に使用されなくなったため、この開発者トークンを使用して 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）アカウントは不要になりました。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 ロールを付与するよう依頼します。