Google Ads APIのCustomerServiceにおける変更予定について
Googleは、Google Ads APIのCustomerService.CreateCustomerClientメソッドに、UIとの整合性向上と不正利用防止のための新たなエラーコードを導入する変更を2025年3月17日に適用した。
キーポイント
変更の目的と実施日
Google Ads APIとGoogle広告UIの新規アカウント作成機能を一致させるため、CustomerService.CreateCustomerClientメソッドに変更を導入し、2025年3月17日に適用した。
新たなエラーコードの導入
ポリシー適用と不正利用制限のため、APIバージョンv19で2つの新しいエラーコード（CustomerError.CREATION_DENIED_INELIGIBLE_MCCなど）を導入した。
子アカウント作成の新条件
ポリシー上の問題がなくても、一定の支出基準額または一定数のアクティブな子アカウントがない場合、子アカウントの作成ができなくなる。
開発者への影響と対応
開発者はAPIバージョンv19以降でこれらの変更に対応する必要があり、エラーコードに基づいた適切なエラーハンドリングの実装が求められる。
影響分析・編集コメントを表示
影響分析
この変更は、Google Ads APIを利用する広告代理店や開発者に直接的な影響を与える。APIとUIの整合性向上によりユーザー体験は改善されるが、新たな作成条件とエラーコードの導入により、開発作業の複雑さが増し、既存のアカウント管理ロジックの見直しが必要となる可能性がある。
編集コメント
技術的なAPI変更通知であり、開発者コミュニティには重要なアップデートだが、AI業界全体への直接的影響は限定的。実装スケジュールと新エラーコードの把握が急務。
*この記事は Anash P. Oommen による Google Ads DeveloperBlog の記事 "Upcoming changes to CustomerService in Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。
*CustomerService.CreateCustomerClient メソッドにいくつかの変更を導入します。これは、Google Ads API と Google 広告 UI の新規アカウント作成機能を一致させるための措置です。この変更は、2025 年 3 月 17 日**に適用されました。
ポリシー適用のための新しいエラーコード**
ポリシーを適用して不正利用を制限するため、Google Ads API バージョン v19 で 2 つの新しいエラーコードを導入しています。
- Google 広告クライアント センター アカウントにポリシー上の問題がない（ポリシー違反のため、一時停止されたり、閉鎖されたりしていないことなど）場合でも、一定の支出基準額または一定数のアクティブな子アカウントがなければ、子アカウントを作成することはできません。Google Ads API の v19 では、CustomerError.CREATION_DENIED_INELIGIBLE_MCC エラーコードが返されます。この問題を解決するには、Google のポリシーに準拠し、クライアント センター アカウントの支出基準額を満たす Google 広告アカウントをリンクしてください。
- アカウント作成に関連するポリシー違反状態の Google 広告クライアント センター アカウントは、子アカウントを作成できなくなります。Google Ads API の v19 では、CustomerError.CREATION_DENIED_FOR_POLICY_VIOLATION エラーコードが返されます。
v18 以前の API バージョンでは、どちらの場合も ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT エラーがスローされます。
アカウント作成の割り当て制限**
Google Ads API による新規 Google 広告アカウントの作成に制限がかかります。上限に達すると QuotaError.RESOURCE_EXHAUSTED エラーが返されます。quota_error_details の retry_delay フィールドには追加情報が含まれており、API 呼び出しの再試行までに必要な待機時間を確認できます。ほとんどのデベロッパーは、この制限の影響を受けることはないでしょう。
何をする必要がありますか？
アプリケーションで Google Ads API を使って新規 Google 広告アカウントを作成している場合は、コードを確認し、新しいエラーコードを正しく処理できることを確認してください。不明な点がある方やサポートが必要な方は、Google Ads API のサポートページでオプションをご確認ください。アカウントのポリシーに関する質問は、Google 広告プロダクト サポートチームまでお問い合わせください。
Posted by Thanet Knack Praneenararat - Ads Developer Relations Team
原文を表示
*この記事は Anash P. Oommen による Google Ads DeveloperBlog の記事 "Upcoming changes to CustomerService in Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。*CustomerService.CreateCustomerClient メソッドにいくつかの変更を導入します。これは、Google Ads API と Google 広告 UI の新規アカウント作成機能を一致させるための措置です。この変更は、2025 年 3 月 17 日に適用されました。ポリシー適用のための新しいエラーコード****ポリシーを適用して不正利用を制限するため、Google Ads API バージョン v19 で 2 つの新しいエラーコードを導入しています。- Google 広告クライアント センター アカウントにポリシー上の問題がない（ポリシー違反のため、一時停止されたり、閉鎖されたりしていないことなど）場合でも、一定の支出基準額または一定数のアクティブな子アカウントがなければ、子アカウントを作成することはできません。Google Ads API の v19 では、CustomerError.CREATION_DENIED_INELIGIBLE_MCC エラーコードが返されます。この問題を解決するには、Google のポリシーに準拠し、クライアント センター アカウントの支出基準額を満たす Google 広告アカウントをリンクしてください。
- アカウント作成に関連するポリシー違反状態の Google 広告クライアント センター アカウントは、子アカウントを作成できなくなります。Google Ads API の v19 では、CustomerError.CREATION_DENIED_FOR_POLICY_VIOLATION エラーコードが返されます。
v18 以前の API バージョンでは、どちらの場合も ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT エラーがスローされます。アカウント作成の割り当て制限**Google Ads API による新規 Google 広告アカウントの作成に制限がかかります。上限に達すると QuotaError.RESOURCE_EXHAUSTED エラーが返されます。quota_error_details の retry_delay フィールドには追加情報が含まれており、API 呼び出しの再試行までに必要な待機時間を確認できます。ほとんどのデベロッパーは、この制限の影響を受けることはないでしょう。何をする必要がありますか？アプリケーションで Google Ads API を使って新規 Google 広告アカウントを作成している場合は、コードを確認し、新しいエラーコードを正しく処理できることを確認してください。不明な点がある方やサポートが必要な方は、Google Ads API のサポートページでオプションをご確認ください。アカウントのポリシーに関する質問は、Google 広告プロダクト サポートチームまでお問い合わせください。
Posted by Thanet Knack Praneenararat - Ads Developer Relations Team
関連記事
今日のまとめ
AI日報で今日の重要ニュースをまとめ読み