サポート終了と廃止

新バージョンのリリースに伴い、サポートが終了するバージョンは廃止日が発表され、その廃止日以降利用できなくなります。他にも、次のようなガイドラインがあります。

  • Google は、常に最大 5 つのメジャー バージョンを利用できるように努めています。
  • メジャー バージョンの有効期間は約 12 か月、マイナー バージョンは 10 か月です。
  • 1 年に最大 2 回のアップグレードを実行する必要があります。アップグレードは厳密な順序で行う必要はありません。たとえば、バージョン（N）からバージョン（N+2）に直接アップグレードできます。

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

時刻表

次の表は、利用可能な各バージョンのサポート終了日と廃止日、および今後のバージョンのリリース予定日を具体的に示したものです。最新バージョンがリリースされたらできるだけ早くアップグレードすることをおすすめします。暫定的な日付とは、その月のいつでもサポート終了となる可能性があり、日付が変更される可能性があることを意味します。ブログに登録して、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 月 2027 年 11 月      
v26.2 2026 年 11 月 2027 年 11 月      
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 を使用するには、サポートが終了したバージョンから直ちにアップグレードする必要があります。

アップグレード ガイドを使用して、最新バージョンにアップグレードすることを強くおすすめします。
時間配分 平均して、3 ～ 4 か月ごとに新しいバージョンがリリースされるため、特定のバージョンは 3 ～ 4 か月後に非推奨になります。 各バージョンは、リリースから 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 バージョンレベルのライフサイクルに焦点を当てていますが、個々の機能のサポート終了（スマート アシスト キャンペーンのサポート終了など）や、バージョン管理されていないワークフローの変更（デマンド ジェネレーション キャンペーンの新しいキャンペーンの予算要件など）は、個別に追跡されます。

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