サポート終了と廃止

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

  • Google では、常に最大 4 つのメジャー バージョンを利用できるように努めています。
  • メジャー バージョンの存続期間は約 12 か月 、マイナー バージョンの存続期間は 10 か月です。
  • アップグレードは 年 2 回 まで行う必要があります。厳密な順序でアップグレードする必要はありません。たとえば、バージョン（N）からバージョン（N+2）に直接アップグレードできます。
  • 最新バージョンのすべてのクライアント ライブラリがリリースされる日付と、サポートが終了するバージョンの日付との間には、少なくとも 20 週間の重複期間があります。

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

時刻表

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

API のバージョンリリース日廃止日アップグレード ガイド
リリース バージョン
v202025 年 6 月 4 日2026 年 6 月（暫定）v19 から v20 にアップグレードする
v20.12025 年 8 月 6 日2026 年 6 月（暫定）v19 から v20 にアップグレードする
v212025 年 8 月 6 日2026 年 8 月（暫定）v20 から v21 にアップグレードする
v222025 年 10 月 15 日2026 年 10 月（暫定）v21 から v22 にアップグレードする
v232026 年 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 月 2027 年 5 月  
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 バージョンで動作するかを示します。

Java

Java 用のクライアント ライブラリ
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: 42.2.0

C#

.NET 用のクライアント ライブラリ
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

PHP 用のクライアント ライブラリ
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

Python 用のクライアント ライブラリ
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Ruby 用のクライアント ライブラリ
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

Perl 用のクライアント ライブラリ
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: 32.0.0

機能の非推奨

Google 広告デベロッパー ブログ を定期的に確認して、今後の機能の非推奨についていち早く把握してください。

次の表に、Google Ads API で予定されている機能の非推奨を示します。各非推奨の詳細については、リンク先のブログ投稿をご覧ください。

機能 説明 発効日 その他の注意事項
データ保持ポリシーの変更 詳細なレポートデータ（日別、時間別、週別）の保持期間が 37 か月に短縮されます。対象期間が長いデータ（月別、四半期別、 年別）は 11 年間利用できます。 2026 年 6 月 1 日 詳しくは、ブログ投稿 をご覧ください。
オフライン コンバージョンのサポートの変更

2026 年 6 月 15 日以降、最近オフライン コンバージョンのリクエストがないデベロッパー トークンは、オフライン コンバージョンのワークフローに Data Manager API を使用する必要があります。

2026 年 6 月 15 日 詳しくは、 ブログ投稿 をご覧ください。
カスタマー マッチのサポートの変更

2026 年 4 月 1 日以降、最近カスタマー マッチのリクエストがないデベロッパー トークンは、カスタマー マッチのワークフローに Data Manager API を使用する必要があります。

 2026 年 4 月 1 日 詳しくは、 ブログ投稿 をご覧ください。
IP アドレスとセッション属性のサポートの変更 Google Ads API では、セッション属性や IP アドレスのデータを新たにコンバージョン インポートに含めることができなくなります。既存のユーザーは Data Manager API に移行する必要があります。 2026 年 2 月 2 日 詳しくは、 ブログ投稿をご覧ください。
電話専用広告の非推奨 新しい電話専用広告は作成できません。既存の電話専用広告は 2027 年 2 月に配信を停止し、API サポートは削除されます。広告主様 は、代わりに電話番号アセット付きのレスポンシブ検索広告を使用する必要があります。 2026 年 1 月 詳しくは、 ブログ投稿をご覧ください。