サポート終了と廃止

新バージョンのリリースに伴い、サポートが終了するバージョンについてはサポート終了日が決まり、その日を過ぎると利用できなくなります。その他のガイドラインは次のとおりです。

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

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

時刻表

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

API のバージョン	リリース日	廃止日	アップグレード ガイド
リリース バージョン
v21	2025 年 8 月 6 日	2026 年 8 月（予定）	v20 から v21 にアップグレードする
v22	2025 年 10 月 15 日	2026 年 10 月（予定）	v21 から v22 にアップグレードする
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 月	2027 年 8 月
v25.1	2026 年 8 月	2027 年 8 月
v25.2	2026 年 9 月	2027 年 8 月
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.v24.services.GoogleAdsService.Mutate など）が含まれます。
4. （省略可）リクエストを表示する対象の期間を選択します。

非推奨と廃止の違い

用語	非推奨	廃止
定義	非推奨のバージョンは、 最新バージョンではないバージョンです。 新しいバージョンがリリースされると、以前のバージョンはすべて 非推奨 とマークされます。	廃止されたバージョンは 使用できなくなります。このバージョンに送信されたリクエストは、廃止日以降に失敗します。
影響	非推奨のバージョンは、廃止されるまで引き続き使用できますが、非推奨のバージョンの参照は強調表示されなくなり、最新バージョンではないことが示されます。 新機能を活用するため、できるだけ早く最新バージョンにアップグレードすることをおすすめします。	Google Ads API を使用するには、廃止されたバージョンから すぐに アップグレードする必要があります。 アップグレード ガイドを使用して、最新 バージョンにアップグレードすることを強くおすすめします。
タイミング	通常、新しいバージョンは 3 ～ 4 か月ごとにリリースされるため、指定された バージョンは約 3 ～ 4 か月後に非推奨になります。	バージョンはリリースから 1 年後に廃止される予定です。
API	非推奨バージョンの API エンドポイントは 引き続き通常どおり 機能します。 クライアント ライブラリと REST を使用して API エンドポイントにアクセスできます。 ただし、非推奨のバージョンには新しい機能は追加されません。	廃止されたバージョンの API エンドポイントは、廃止日以降 機能しなくなります 。廃止されたバージョンの API エンドポイントにアクセスしようとすると、Google Ads API からエラーが返されます。
クライアント ライブラリ	コンパクトなクライアント ライブラリを提供するため、非推奨日以降、新しいクライアント ライブラリ バージョンに非推奨の API バージョンを 含めなくなります 。これにより、プロジェクトにクライアント ライブラリを組み込む際の容量を節約できます。	クライアント ライブラリは、廃止日以降の新しいクライアント ライブラリ バージョンで、廃止された API バージョンを サポートしなくなります。
サポート	非推奨のバージョンは定期的にサポートされます。	廃止されたバージョンは、廃止日以降サポートされなくなります。

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

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

記載されている最小クライアント ライブラリ バージョンは、Google Ads API のメジャー リリース（v24 など）で十分です。マイナー リリースに必要なクライアント ライブラリのバージョンについては、リンク先の変更履歴をご覧ください。

機能の非推奨と変更

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

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