サポートの終了と廃止

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

  • 一度に使用できるメジャー バージョンは最大 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 年 10 月 16 日 2025 年 6 月 4 日 v17 から v18 へのアップグレード
v17 2024 年 6 月 5 日 2024 年 10 月 16 日 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 広告 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 年 2 月 v16 が廃止されると、すべての GoogleAdsService.Search リクエストで 10,000 行の固定ページサイズが前提となります。
拡張クリック単価入札戦略 Google Ads API では、 検索キャンペーンとディスプレイ キャンペーンの入札戦略として eCPC を設定できなくなりました。 2024 年 10 月 入札戦略の enhanced_cpc_enabled フィールドを TRUE に設定するリクエストは、BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED エラーになります。拡張クリック単価入札戦略を使用している既存のキャンペーンは、2025 年 3 月 15 日まで引き続き配信されます。この日以降、個別クリック単価（CPC）に自動的に移行されます。