サポート終了と廃止

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

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

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

時刻表

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

API バージョン	リリース日	廃止日	アップグレード ガイド
リリース バージョン
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 月 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 エンドポイントは通常どおり機能します。 Google の API エンドポイントには、クライアント ライブラリと REST を使用してアクセスできます。ただし、非推奨バージョンには新機能は追加されません。	廃止されたバージョンの API エンドポイントは、廃止日以降は機能しなくなります。廃止されたバージョンの API エンドポイントにアクセスしようとすると、Google Ads API はエラーをスローします。
クライアント ライブラリ	コンパクトなクライアント ライブラリを提供するため、非推奨の API バージョンは、非推奨日以降に新しいクライアント ライブラリ バージョンに含まれなくなります。これにより、プロジェクトにクライアント ライブラリを組み込む際にスペースを節約できます。	クライアント ライブラリは、廃止日以降の新しいクライアント ライブラリ バージョンで、廃止された API バージョンをサポートしなくなります。
サポート	非推奨バージョンについては、定期的なサポートを提供します。	廃止されたバージョンは、廃止日を過ぎるとサポートされなくなります。

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

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

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

機能の非推奨と変更

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

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