サポート終了と廃止

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

• 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 月 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 など）で十分です。マイナー リリースに必要なクライアント ライブラリ バージョンについては、リンク先の変更履歴をご覧ください。

機能の非推奨と変更

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

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