サポート終了と廃止

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

  • 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 で予定されている特定の機能の非推奨を示します。各非推奨の詳細については、リンク先のブログ投稿をご覧ください。

機能 説明 発効日 その他の注意事項
オフライン コンバージョンのサポートの変更

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

  • 2025 年 12 月 17 日から 2026 年 6 月 15 日の間に、開発者トークンから UploadClickConversions リクエストが送信された場合は、オフライン コンバージョン ワークフローで Google Ads API を引き続き使用できます。ただし、デベロッパー エクスペリエンスの向上と追加機能へのアクセスを実現するため、オフライン コンバージョン ワークフローを Data Manager API にアップグレードすることをおすすめします。
  • それ以外の場合、2026 年 6 月 15 日以降、 UploadClickConversions リクエストは CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE エラーで失敗します。 オフライン コンバージョン ワークフローには、Google Ads API ではなく 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 月 詳しくは、 ブログ投稿をご覧ください。