サポート終了と廃止

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

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

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

時刻表

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

API のバージョンリリース日サポート終了日廃止日アップグレード ガイド
v212025 年 8 月 6 日v20 から v21 にアップグレードする
v20.12025 年 8 月 6 日2026 年 6 月（予定）v19 から v20 にアップグレードする
v202025 年 6 月 4 日2026 年 6 月（予定）v19 から v20 にアップグレードする
v19.22025 年 8 月 6 日2026 年 2 月（予定）v18 から v19 にアップグレードする
v19.12025 年 4 月 16 日2026 年 2 月（予定）v18 から v19 にアップグレードする
v192025 年 2 月 26 日2026 年 2 月（予定）v18 から v19 にアップグレードする
v182024 年 10 月 16 日2025 年 6 月2025 年 8 月 20 日

プロジェクトで使用しているバージョンを表示する

プロジェクトが最近呼び出したメソッドとサービスのリストは、Google Cloud コンソールで確認できます。

  1. Google Cloud コンソールで [API とサービス] を開きます。
  2. 表で [Google Ads API] をクリックします。
  3. [指標] サブタブに、最近のリクエストが各グラフにプロットされます。リクエストを送信したメソッドは、[メソッド] テーブルで確認できます。メソッド名には、Google Ads API のバージョン、サービス、メソッド名が含まれます（例: google.ads.googleads.v21.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 用のクライアント ライブラリ
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#

.NET 用のクライアント ライブラリ
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

PHP 用クライアント ライブラリ
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

Python

Python 用のクライアント ライブラリ
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Ruby

Ruby 用クライアント ライブラリ
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

Perl 用のクライアント ライブラリ
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

機能の非推奨

Google 広告デベロッパー ブログを定期的にチェックして、今後の機能の非推奨化に関する最新情報をいち早く入手してください。

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

機能 説明 発効日 その他の情報
アプリ キャンペーンのパフォーマンスに影響するコンバージョン環境 2025 年 9 月 30 日より、入札モデルの変更を段階的に導入し、インポートされたコンバージョンに含まれるコンバージョン環境データを使用してキャンペーンのパフォーマンスを最適化できるようになります。 2025 年 10 月 3 日 詳しくは、こちらのブログ投稿をご覧ください。
コンバージョンには `gclid` と `gbraid` の両方の値を含めることができます。 2025 年 10 月 3 日以降、`gclid` フィールドと `gbraid` フィールドの両方が設定されている場合、インポートされたコンバージョンで `VALUE_MUST_BE_UNSET` エラーが返されなくなります。 2025 年 10 月 3 日 詳しくは、こちらのブログ投稿をご覧ください。