サポート終了と廃止

Google Ads API では、複数のアクティブなメジャー バージョンが常に維持されます。バージョンが非推奨と見なされるのは、明示的に非推奨とマークされている場合のみです。アップグレードの計画に役立つよう、リリース日とサポート終了日は事前に公開されます。バージョンの廃止日を過ぎると、そのバージョンは利用できなくなります。バージョニングの主なガイドラインは次のとおりです。

  • Google は、常に最大 5 つのメジャー バージョンを利用できるように努めています。
  • メジャー バージョンの有効期間は 12 か月程度です。API のマイナー バージョンのライフスパンは個別に追跡されません。代わりに、マイナー バージョンは、対応するメジャー バージョンと同じ提供終了日を共有します。
  • 各マイナー バージョンは、対応するメジャー バージョンを増分アップデートします。
  • 特定のメジャー バージョンに対するすべての API 呼び出しは、常に、対応する最新のマイナー バージョンに送信されます。Google Ads API は、特定のマイナー バージョンの呼び出しをサポートしていません。
  • 1 年に最大 2 回のアップグレードを実行する必要があります。アップグレードを厳密な順序で実行する必要はありません。たとえば、バージョン(N)からバージョン(N+2)に直接アップグレードできます。
  • Google Ads API を初めてご利用の場合は、v26 から始めることをおすすめします。

クライアント ライブラリは、サービスの利用可能なバージョンをサポートしているため、使用するサービスの異なるバージョンを指定して段階的にアップグレードできます。

時刻表

次の表に、利用可能な各バージョンのリリース日と廃止日、および今後のバージョンのリリース予定日を示します。最新バージョンがリリースされたらできるだけ早くアップグレードすることをおすすめします。暫定的な日付とは、その月のいつでもサポート終了が発生する可能性があり、日付が変更される可能性があることを意味します。ブログに登録して、API バージョンのサポート終了のお知らせのリマインダーを受け取ってください。

API バージョン リリース日 廃止日 互換性を破る変更とアップグレード 機能とアップデート proto の違いを示す表
リリース バージョン
v23 2026 年 1 月 28 日 2027 年 2 月 v23 の互換性を破る変更(アップグレード ガイド) v23 の機能とアップデート v22 と v23 の proto の差分
v23.1 2026 年 2 月 25 日 2027 年 2 月 なし(マイナー リリース) v23.1 の機能とアップデート v22 と v23 の proto の差分
v23.2 2026 年 3 月 25 日 2027 年 2 月 なし(マイナー リリース) v23.2 の機能とアップデート v22 と v23 の proto の差分
v23.3 2026 年 6 月 24 日 2027 年 2 月 なし(マイナー リリース) v23.3 の機能とアップデート v22 と v23 の proto の差分
v24 2026 年 4 月 22 日 2027 年 5 月 v24 の互換性を破る変更(アップグレード ガイド) v24 の機能とアップデート v23 と v24 の proto の差分
v24.1 2026 年 5 月 13 日 2027 年 5 月 なし(マイナー リリース) v24.1 の機能とアップデート v23 と v24 の proto の差分
v24.2 2026 年 6 月 24 日 2027 年 6 月 なし(マイナー リリース) v24.2 の機能とアップデート v23 と v24 の proto の差分
v25 2026 年 7 月 22 日 2027 年 8 月 v25 の互換性を破る変更(アップグレード ガイド) v25 の機能とアップデート v24 と v25 の proto の差分
v25.1 2026 年 8 月 19 日 2027 年 8 月 なし(マイナー リリース) v25.1 の機能とアップデート v24 と v25 の proto の差分
v25.2 2026 年 9 月 23 日 2027 年 8 月 なし(マイナー リリース) v25.2 の機能とアップデート v24 と v25 の proto の差分
v26(最新) 2026 年 10 月 14 日 2027 年 11 月 v26 の互換性を破る変更(アップグレード ガイド) v26 の機能と更新情報 v25 と v26 の proto の差分
v26.1 2026 年 10 月 28 日 2027 年 11 月 なし(マイナー リリース) v26.1 の機能とアップデート v25 と v26 の proto の差分
v26.2 2026 年 11 月 11 日 2027 年 11 月 なし(マイナー リリース) v26.2 の機能とアップデート v25 と v26 の proto の差分
今後のバージョン
v26.3* 2026 年 12 月 2027 年 11 月      
v27 2027 年 1 月 2028 年 2 月      
v27.1 2027 年 2 月 2028 年 2 月      
v27.2 2027 年 2 月 2028 年 2 月      
v27.3 2027 年 3 月 2028 年 2 月      
v27.4 2027 年 3 月 2028 年 2 月      
v28 2027 年 4 月 2028 年 5 月      
v28.1 2027 年 4 月 2028 年 5 月      
v28.2 2027 年 5 月 2028 年 5 月      
v28.3 2027 年 5 月 2028 年 5 月      
v28.4 2027 年 6 月 2028 年 5 月      
v28.5 2027 年 6 月 2028 年 5 月      
v29 2027 年 7 月 2028 年 8 月      
v29.1 2027 年 7 月 2028 年 8 月      
v29.2 2027 年 8 月 2028 年 8 月      
v29.3 2027 年 8 月 2028 年 8 月      
v29.4 2027 年 9 月 2028 年 8 月      
v29.5 2027 年 9 月 2028 年 8 月      
v30 2027 年 10 月 2028 年 11 月      
v30.1 2027 年 10 月 2028 年 11 月      
v30.2 2027 年 11 月 2028 年 11 月      
v30.3* 2027 年 12 月 2028 年 11 月      

* v26.3 と v30.3 は、ホリデー シーズンと重なるため、オプションのリリースに指定されています。

プロジェクトで使用しているバージョンを確認する

プロジェクトで最近呼び出されたメソッドとサービスの一覧は、Google Cloud コンソールで確認できます。

  1. Google Cloud コンソールで [API とサービス] を開きます。
  2. 表の [Google Ads API] をクリックします。
  3. [指標] サブタブで、最近のリクエストが各グラフにプロットされていることを確認します。リクエストを送信したメソッドは、[メソッド] テーブルで確認できます。メソッド名には、Google Ads API のバージョン、サービス、メソッド名が含まれます(例: google.ads.googleads.v26.services.GoogleAdsService.Mutate)。
  4. (省略可)リクエストを表示する対象の期間を選択します。

「サポート終了」と「廃止」の違い

用語非推奨夕暮れ
定義 バージョンは、明示的に非推奨としてマークされている場合にのみ、非推奨と見なされます。Google Ads API には、常に複数のアクティブなメジャー バージョンがあります。 廃止済みのバージョンは使用できなくなります。このバージョンに送信されたリクエストは、廃止日以降に失敗します。
影響 非推奨のバージョンは、サポートが終了するまで引き続き使用できますが、非推奨のバージョンの参照は、最新バージョンではなくなったことを示すためにハイライト表示が解除されます。

新機能をご利用いただけるよう、できるだけ早く最新バージョンにアップグレードすることをおすすめします。

Google Ads API を使用するには、サポートが終了したバージョンから直ちにアップグレードする必要があります。

アップグレード ガイドを使用して、最新バージョンにアップグレードすることを強くおすすめします。

時間配分 サポート終了日は事前に公開されます。バージョンは、明示的に非推奨とマークされている場合にのみ非推奨と見なされます。 Google では、リリースから 1 年後にバージョンを廃止することを目指しています。
API 非推奨バージョンの API エンドポイントは、引き続き通常どおり機能します。

API エンドポイントには、クライアント ライブラリと REST を使用してアクセスできます。ただし、非推奨のバージョンに新機能は追加されません。

廃止されたバージョンの API エンドポイントは、廃止日以降機能しなくなります。サポートが終了したバージョンの API エンドポイントにアクセスしようとすると、Google Ads API でエラーが発生します。
クライアント ライブラリ コンパクトなクライアント ライブラリを提供するため、非推奨となった API バージョンは、非推奨日以降の新しいクライアント ライブラリ バージョンには含まれなくなります。これにより、プロジェクトにクライアント ライブラリを組み込む際のスペースを節約できます。 クライアント ライブラリは、廃止日以降の新しいクライアント ライブラリ バージョンで、廃止された API バージョンをサポートしなくなります。
サポート 非推奨のバージョンに対しては、通常のサポートが提供されます。 廃止済みのバージョンは、廃止日を過ぎるとサポートされません。

サポートされているクライアント ライブラリのバージョン

この表は、どのクライアント ライブラリがどの API バージョンで動作するかを示しています。

記載されている最小クライアント ライブラリ バージョンは、Google Ads API のメジャー リリース(v26 など)に対応しています。マイナー リリースに必要なクライアント ライブラリのバージョンを確認するには、リンク先の変更履歴をご覧ください。

Java

変更履歴

Java 用のクライアント ライブラリ
v26 Min: 48.0.0
Max: -
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

変更履歴

.NET 用のクライアント ライブラリ
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

変更履歴

PHP 用クライアント ライブラリ
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

変更履歴

Python 用のクライアント ライブラリ
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

変更履歴

Ruby 用クライアント ライブラリ
v26 Min: 46.0.0
Max: -
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

変更履歴

Perl 用のクライアント ライブラリ
v26 Min: 36.0.0
Max: -
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

機能の非推奨と変更

このページでは API バージョンレベルのライフサイクルに焦点を当てていますが、個々の機能のサポート終了(スマート アシスト キャンペーンのサポート終了など)や、バージョン管理されていないワークフローの変更(新しいデマンド ジェネレーション キャンペーンのキャンペーンの予算要件など)は、個別に追跡されます。

アクティブなバージョン全体で今後の機能のライフサイクルと挙動のシフトを確認するには、機能のサポート終了とバージョニングされていない変更のガイドをご覧ください。