サポート終了と廃止

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

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

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

時刻表

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

API バージョンリリース日廃止日アップグレード ガイド
リリース バージョン
v232026 年 1 月 28 日2027 年 2 月v22 から v23 にアップグレードする
v23.1 2026 年 2 月 25 日 2027 年 2 月 v23 から v23.1 にアップグレードする
v23.2 2026 年 3 月 25 日 2027 年 2 月 v23.1 から v23.2 にアップグレードする
v24 2026 年 4 月 22 日 2027 年 5 月 v23.2 から v24 にアップグレードする
v24.1 2026 年 5 月 13 日 2027 年 5 月 v24 から v24.1 にアップグレードする
v24.2 2026 年 6 月 24 日 2027 年 6 月 v24.1 から v24.2 にアップグレードする
v25 2026 年 7 月 22 日 2027 年 8 月 v24.2 から v25 にアップグレードする
v25.1 2026 年 8 月 19 日 2027 年 8 月 v25 から v25.1 にアップグレードする
v25.2 2026 年 9 月 23 日 2027 年 8 月 v25.1 から v25.2 にアップグレードする
v26 2026 年 10 月 14 日 2027 年 11 月 v25.2 から v26 にアップグレードする
今後のバージョン
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.googleads.v26.services.GoogleAdsService.Mutate のように、Google Ads API バージョン、サービス、メソッド名が含まれます。
  4. （省略可）リクエストを表示する対象の期間を選択します。

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

用語非推奨廃止
定義 サポートが終了したバージョンは、最新バージョンではないバージョンです。 新しいバージョンがリリースされると、以前のすべてのバージョンが サポート終了 となります。 廃止されたバージョンは使用できなくなります。このバージョンに送信されたリクエストは、廃止日以降に失敗します。
影響 サポートが終了したバージョンは、廃止されるまで引き続き使用できますが、 サポートが終了したバージョンの参照は強調表示されなくなり、 最新バージョンではなくなったことが示されます。

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

Google Ads API を使用するには、廃止されたバージョンから直ちに アップグレードする必要があります。

アップグレード ガイドを使用して、最新 バージョンにアップグレードすることを強くおすすめします。
タイミング 通常、新しいバージョンは 3 ～ 4 か月ごとにリリースされるため、指定された バージョンは約 3 ～ 4 か月後にサポート終了となります。 バージョンはリリースから 1 年後に廃止される予定です。
API サポートが終了したバージョンの API エンドポイントは通常どおり機能します 。

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

 廃止されたバージョンの 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 バージョン レベルのライフサイクルについて説明しますが、個々の機能の非推奨（スマート アシスト キャンペーンの非推奨など）や、バージョン管理されていないワークフローの変更（新しいデマンド ジェネレーション キャンペーンのキャンペーンの予算要件など）は個別に追跡されます。

今後の機能のライフサイクルと、有効な バージョン間での挙動のシフトを確認するには、 機能の非推奨とバージョン管理されていない変更に関するガイドをご覧ください。