サポート終了と廃止

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

• 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 月 22 日	2027 年 8 月	v24.2 から v25 へのアップグレード
今後のバージョン
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.v25.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 のメジャー リリース（v25 など）で十分です。マイナー リリースに必要なクライアント ライブラリのバージョンについては、リンク先の変更ログをご覧ください。

機能の非推奨と変更

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

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