サポート終了と廃止

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

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

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

時刻表

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

API バージョン	リリース日	廃止日	アップグレード ガイド
リリース バージョン
v23	2026 年 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 月	2027 年 11 月
v26.1*	2026 年 11 月	2027 年 11 月

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

プロジェクトで使用されているバージョンを表示する

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

1. Google Cloud コンソールで [API とサービス] を開きます。
2. 表の [Google Ads API] をクリックします。
3. [指標] サブタブで、最近のリクエストが各グラフにプロットされていることを確認します。リクエストを送信したメソッドは、[メソッド] テーブルで確認できます。メソッド名には、Google Ads API のバージョン、サービス、メソッド名（google.ads.googleads.v25.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 のメジャー リリース（v25 など）に十分です。マイナー リリースに必要なクライアント ライブラリのバージョンについては、リンク先の変更ログをご覧ください。

機能の非推奨と変更

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

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