開発者トークン

開発者トークンは、アプリを 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 プロジェクトによって決定されるようになりました。

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 プロジェクトを使用して本番環境アカウントを呼び出そうとすると、CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION エラーが返されます。古い API バージョンでは、代わりに ACTION_NOT_PERMITTED エラーがスローされます。このエラーが発生した場合は、Google Cloud プロジェクトの Google Ads API の概要ページに移動して、Explorer アクセスを申請してください。

基本アクセスと標準アクセスにはブランドの確認が必要です

新しい基本アクセスと標準アクセスの申請では、Google Cloud プロジェクトのブランドの確認を完了する必要があります。既存のアクセス権所有者は、ブランドの確認を完了する必要はありませんが、完了することが推奨されます。

ベーシック アクセスの申請が自動化され、ブランドの確認と申請の送信後数分以内に審査が行われるようになりました。

これらのプロセスの更新により、この移行の一環として、保留中のすべての Basic API アクセス申請が終了します。影響を受ける申請者には、詳細を記載したメールが届きます。Google Ads API の概要ページから API へのアクセスを再度申請してください。

新しい API の連絡先メールアドレス

API Center ページの廃止に向けて、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 を送信します。このプロセスが更新されるたびに、お知らせいたします。

アプリのコードを修正する: API 呼び出しの一部として開発者トークンを送信しないように、アプリを更新することをおすすめします。クライアント ライブラリ、Google Ads MCP サーバー、Google Ads API Developer Assistant の更新版を公開しました。これにより、開発者トークンを設定せずに API 呼び出しを行うことができます。Google Ads API の今後のメジャー バージョンでは、API 呼び出しでデベロッパー トークンが拒否されるようになります。アプリでこれらのライブラリを使用している場合は、最新バージョンを使用するようにアプリの依存関係を更新してください。

さらにサポートが必要な場合や、ご不明な点がある場合は、Google Ads API サポートにお問い合わせください。

よくある質問

API アクセスレベルはどうなりますか？

Google Ads API では、API アクセスレベルが引き続き適用されます。ただし、これらの権限はデベロッパー トークンではなく、Google Cloud コンソール プロジェクトに付与されるようになりました。API 呼び出しを行うと、OAuth 認証情報の生成に使用した Google Cloud プロジェクトによって API アクセスレベルが決定されるようになります。

API アクセスレベルの転送対象のプロジェクトはどのように特定されましたか？

2026 年 9 月 9 日より前に承認済みのデベロッパー トークンをお持ちの場合、そのアクセスレベルは次のように Google Cloud プロジェクトに転送されています。

  • 過去 90 日間の API 呼び出しログを調べ、承認済みの開発者トークンを使用して API 呼び出しを行った Cloud プロジェクトを特定しました。
  • 特定されたすべての Cloud プロジェクトに、デベロッパー トークンの API アクセスレベルを割り当てました。

この変更後、さまざまなアクセスレベルを持つ複数の Cloud プロジェクトを作成できますか？」

はい。API アクセスレベルが異なる複数の Google Cloud プロジェクトを使用できます。たとえば、Basic Access の Google Cloud プロジェクトと Standard Access の Google Cloud プロジェクトをそれぞれ 1 つずつ作成できます。

例

たとえば、次の詳細を含む 4 つのデベロッパー トークンと 6 つの Cloud プロジェクトがあるとします。

  • 開発者トークン 1: abcdefghijkl1234567890 には標準権限があります。プロジェクト ID 1234567890、5678912345、45678912345 で使用されています。
  • 開発者トークン 2: xyzabcdefghi6789012345 には基本アクセス権があります。プロジェクト ID 1231235678 で使用されています。
  • デベロッパー トークン 3: asdfgflkjhjz7654321012 はベーシック アクセス権を持っていますが、API 呼び出しに使用されたことはありません。最近承認されました。
  • デベロッパー トークン 4: qwertypoiuyu6543298790 は標準アクセス権を持っていますが、過去 90 日間使用されていません。プロジェクト ID 9876564900 は、過去にこの開発者トークンで使用されています。
  • 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 の概要ページから、Basic アクセスを再度申請してください。この変更の影響を受ける場合は、必要な手順を記載したメールが届きます。

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 つの可能性があります。

  1. 非アクティブ状態が続くと、開発者トークンへのアクセスが取り消される可能性があります。Google のポリシーに準拠して、90 日間連続で使用されていない API トークンは取り消されることがあります。開発者トークンをしばらく使用していない場合、非アクティブ状態が続いたため、アクセスレベルが取り消された可能性があります。この場合は、Google Ads API の概要ページから Google Cloud プロジェクトの API アクセスを再度申請してください。例をご覧ください。

  2. 開発者トークンが最近承認されたが、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 マネージド アクセスレベルのパイロット プログラムに参加していました。どのような影響がありますか？

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 センターから開発者トークンをリセットすることもできます。

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 センターは近い将来に廃止される予定です。

次へ
アクセスレベルと許可されている用途