サポート終了と廃止

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

• 一度に利用できるメジャー バージョンは最大 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 年 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 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 バージョンレベルのライフサイクルに焦点を当てていますが、個々の機能のサポート終了（スマート アシスト キャンペーンのサポート終了など）や、バージョン管理されていないワークフローの変更（デマンド ジェネレーション キャンペーンの新しいキャンペーンの予算要件など）は、個別に追跡されます。

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