2026 年 9 月 10 日（木）
デベロッパーのオンボーディングと使用体験を改善するため、Google Cloud コンソールに Google Ads API の新しいホームページを構築しました。ブランドの確認を完了したデベロッパーは、基本アクセスの申請が自動化されるようになりました。このブログ投稿では、本日より適用が開始されるいくつかの関連する変更について説明します。デベロッパーの皆様は、この投稿の要対応セクションを確認し、スムーズに移行できるようにしてください。
API アクセス管理の変更
Google Ads API へのアクセスの登録と管理の方法が更新されます。
Google Ads API の新しいオンボーディング エクスペリエンス: Google 広告 MCC アカウントがなくても、Google Cloud コンソールで直接 Google Ads API へのアクセスに登録できるようになりました。マネージャー アカウントの [API センター] ページにある新規登録と API アクセス管理の機能はすべて廃止され、Google Cloud コンソールの [Google Ads API の概要] ページに移行されます。API センターのページにアクセスすると、以前のデベロッパーの詳細情報を参照できます。このページは今後完全に廃止される予定です。
API のアクセスレベルが Google Cloud プロジェクトに関連付けられる: デベロッパー トークンは廃止されます。現在有効な開発者トークンのアクセスレベルは、最近の API のご利用状況に基づいて、Google Cloud プロジェクトに自動的に移行されます。API 呼び出しのヘッダーに開発者トークンを含めることは引き続き可能ですが、これは任意であり、API サーバーでは無視されます。既存のコードは変更なしで引き続き機能します。API アクセスレベルは、OAuth 認証情報の生成に使用した Google Cloud プロジェクトによって決まるようになりました。今回の変更について詳しくは、よくある質問のページをご覧ください。また、問題が発生した場合は、このページでトラブルシューティングの方法をご確認ください。
新しいエラーコード: Google Ads API のバージョン v25 では、テストアカウントのアクセスレベルの Google Cloud プロジェクトを使用して本番環境アカウントを呼び出そうとすると、CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION エラーがスローされます。それより前のバージョンの API では、代わりに ACTION_NOT_PERMITTED エラーがスローされます。このエラーが発生した場合は、Google Cloud プロジェクトの Google Ads API の概要ページに移動し、エクスプローラ アクセスを申請してください。
API 審査プロセスの変更
ベーシック アクセスと標準アクセスにはブランドの確認が必要: ベーシック アクセスと標準アクセスの新規申請では、Google Cloud プロジェクトのブランドの確認を完了する必要があります。既存のアクセス権保持者は、ブランドの確認を完了する必要はありませんが、完了することをおすすめします。
Basic アクセス承認の自動化: Basic アクセス申請が自動化され、ブランド確認と送信から数分以内に審査されるようになりました。
保留中の Basic アクセス申請の 1 回限りの拒否: これらのプロセス更新により、保留中の Basic API アクセス申請はすべて、この移行の一環として閉じられます。影響を受ける申請者には、詳細を記載したメールが届きます。Google Ads API の概要ページから API アクセスを再申請してください。
必要な対応
API アクセスを確認する: プロジェクトの API アクセスレベルが、既存の開発者トークンと正しく一致していることを確認します。
- 開発者トークンのアクセスレベルは、Google 広告クライアント センター（MCC）アカウントの API センターで確認できます。
- Google Ads API の概要ページで、Google Cloud プロジェクトに同じアクセスレベルが設定されていることを確認します。
- アクセスレベルが一致しない場合は、Google Ads API の概要ページから API アクセスを再申請するか、Google Ads API サポートにお問い合わせください。
API の連絡先メールアドレスの更新: Cloud プロジェクトの IAM（Identity and Access Management）ページにアクセスします。オーナーロールと編集者ロールのユーザーのリストが最新であることを確認します。今後、Google Ads API に変更がある場合は、これらのメールアドレスにサービスに関する重要なお知らせ（MSA）をお送りします。
コードの変更: API 呼び出しの一部として開発者トークンを送信しないよう、アプリケーション コードを更新することをおすすめします。開発者トークンを設定せずに API 呼び出しを行えるよう、クライアント ライブラリの新しいバージョンを公開しました。Google Ads API の今後のメジャー バージョンでは、API 呼び出しで開発者トークンが拒否されるようになります。
該当する場合は API アクセスを再申請する: 審査待ちのベーシック API アクセスの申請がこの移行の一環として終了した場合は、Google Cloud コンソールの Google Ads API の概要ページから API アクセスを再申請してください。
これらの変更に対応できるよう、更新されたドキュメントを公開しました。テクニカル サポートに関する問題については、よくある質問のページをご覧いただくか、Google Ads API サポートにお問い合わせください。ご不明な点がある場合や、この投稿についてディスカッションをご希望の場合は、Google 広告および測定のコミュニティ Discord サーバーまでお問い合わせください。
- Anash P. Google Ads API チーム、Oommen
ラベル: google-ads-api、 release