サポートの終了と廃止

新しいバージョンのリリースに伴い、サポートが終了するバージョンには廃止日が設定され、その日を過ぎると利用できなくなります。次の点にも注意する必要があります。

  • 一度に使用できるメジャー バージョンは 3 つまでです。
  • メジャー バージョンの存続期間は約 12 か月、マイナー バージョンは 10 か月です。
  • 年に 2 回までアップグレードを行う必要があります。厳密に順番にアップグレードする必要はありません。たとえば、バージョン（N）からバージョン（N+2）に直接アップグレードできます。
  • 最新バージョンのすべてのクライアント ライブラリがリリースされてから廃止されるバージョンまでの期間は、20 週間以上です。

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

時刻表

次の表に、利用可能な各バージョンの具体的なサポート終了日と廃止日、および今後のバージョンのリリース予定日を示します。最新バージョンがリリースされたらできるだけ早くアップグレードすることをおすすめします。

API のバージョン リリース日 サポート終了日 廃止日 アップグレード ガイド
v18 2024 年 10 月 16 日 2025 年 2 月 2025 年 9 月 24 日
v17.1 2024 年 8 月 7 日 2024 年 9 月 / 10 月 2025 年 6 月 4 日 v17 から v18 へのアップグレード
v17 2024 年 6 月 5 日 2024 年 9 月 / 10 月 2025 年 6 月 4 日 v17 から v18 へのアップグレード
v16.1 2024 年 4 月 24 日 2024 年 6 月 5 日 2025 年 2 月 5 日 v16 から v17 へのアップグレード
v16 2024 年 2 月 21 日 2024 年 6 月 5 日 2025 年 2 月 5 日 v16 から v17 へのアップグレード

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

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

  1. Google Cloud コンソールで [API とサービス] を開きます。
  2. 表内の [Google Ads API] をクリックします。
  3. [METRICS] サブタブで、各グラフに最近のリクエストがプロットされたことがわかります。リクエストを送信したメソッドは、[メソッド] テーブルで確認できます。メソッド名には、Google Ads API のバージョン、サービス、メソッド名が含まれます（例: google.ads.googleads.v18.services.GoogleAdsService.Mutate）。
  4. （省略可）リクエストを表示する期間を選択します。

非推奨と廃止の違い

用語非推奨夕暮れ
定義 非推奨バージョンは最新ではありません。 新しいバージョンがリリースされると、以前のバージョンはすべて非推奨になります。 廃止バージョンはご利用いただけなくなりました。このバージョンに送信されたリクエストは、廃止日以降に失敗します。
影響 非推奨バージョンは廃止されるまで引き続き使用できますが、非推奨バージョンへの参照はハイライト表示され、最新バージョンではないことが示されます。

新機能を活用するために、できるだけ早く最新バージョンにアップグレードすることをおすすめします。

 Google Ads API を使用するには、廃止対象バージョンから直ちにアップグレードする必要があります。

アップグレード ガイドを使用して最新バージョンにアップグレードすることを強くおすすめします。
時間配分 新しいバージョンは平均で 3～4 か月ごとにリリースされるため、特定のバージョンは約 3～4 か月後に非推奨になります。 バージョンは、リリースから 1 年後に廃止することを目指しています。
API 非推奨バージョンの API エンドポイントは、引き続き通常どおり機能します。

Google のクライアント ライブラリ、REST などを使用して API エンドポイントにアクセスできますが、非推奨のバージョンには新機能は追加されません。

 廃止されたバージョンの API エンドポイントは、廃止日以降機能しなくなります。廃止バージョンの API エンドポイントにアクセスしようとすると、Google Ads API からエラーがスローされます。
クライアント ライブラリ コンパクトなクライアント ライブラリを提供するため、非推奨の API バージョンは、非推奨日以降の新しいクライアント ライブラリ バージョンに含めることを停止します。これにより、Google のクライアント ライブラリをプロジェクトに組み込む際にスペースを節約できます。 クライアント ライブラリでは、廃止日をすぎると、新しいクライアント ライブラリのバージョンでは廃止された API バージョンがサポートされなくなりました。
サポート 非推奨のバージョンについては、定期的なサポートを提供しています。 廃止されたバージョンは、廃止日以降サポートされなくなります。

サポートされているクライアント ライブラリのバージョン

次の表に、どのクライアント ライブラリがどの API バージョンに対応しているかを示します。

Java

Java 用のクライアント ライブラリ
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: -

C#

.NET 用のクライアント ライブラリ
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: -

PHP

PHP 用クライアント ライブラリ
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

Python 用のクライアント ライブラリ
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

Ruby

Ruby 用クライアント ライブラリ
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

Perl 用のクライアント ライブラリ
v18 Min: 25.0.0
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

機能の非推奨

Google 広告デベロッパー ブログを定期的にチェックして、サポート終了予定の機能に関する情報をいち早く入手してください。

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

機能 説明 発効日 その他の情報
Google Ads API のページサイズに関する今後の変更について v16 のサポートが終了すると、GoogleAdsService.Search リクエストの送信時に page_size フィールドを設定できなくなります。 2025 年 1 月 v16 が廃止されると、すべての GoogleAdsService.Search リクエストで 10,000 行の固定ページサイズが前提となります。
拡張クリック単価入札戦略 Google Ads API では、 検索キャンペーンとディスプレイ キャンペーンの入札戦略として eCPC を設定できなくなりました。 2024 年 10 月 入札戦略で enhanced_cpc_enabled フィールドを TRUE に設定すると、BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED エラーが発生します。拡張クリック単価入札戦略を使用している既存のキャンペーンは、2025 年 3 月 15 日まで引き続き配信されます。この日以降、自動的に個別クリック単価（CPC）に移行されます。