サポートの終了と廃止

新バージョンがリリースされると、サポートが終了したバージョンに廃止日が与えられます。廃止日を過ぎると、そのバージョンは利用できなくなります。次のガイドラインにもご注意ください。

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

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

時刻表

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

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

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

Google Cloud コンソールを使用して、プロジェクトで最近呼び出されたメソッドとサービスのリストを表示できます。

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

サポート終了と廃止の違い

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

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

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

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

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

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

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

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

Java

Java 用のクライアント ライブラリ
v16 Min: 30.0.0
Max: -
v15 Min: 28.0.0
Max: -
v14 Min: 26.0.0
Max: -

C#

.NET 用のクライアント ライブラリ
v16 Min: 18.1.0
Max: -
v15 Min: 17.1.0
Max: -
v14 Min: 16.1.0
Max: -

PHP

PHP 用クライアント ライブラリ
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: -
v14 Min: 19.2.0
Max: -

Python

Python 用のクライアント ライブラリ
v15 Min: 22.1.0
Max: -
v14 Min: 21.2.0
Max: -

Ruby

Ruby 用のクライアント ライブラリ
v16 Min: 27.0.0
Max: -
v15 Min: 25.0.0
Max: -
v14 Min: 23.0.0
Max: -

Perl

Perl 用のクライアント ライブラリ
v16 Min: 21.0.0
Max: -
v15 Min: 19.0.0
Max: -
v14 Min: 17.0.0
Max: -

機能の非推奨

Google 広告デベロッパー ブログを定期的にチェックして、サポート終了予定の機能についていち早くお知らせします。

下の表は、Google Ads API で現在サポート終了が予定されている具体的な機能の一覧です。各非推奨の詳細については、リンク先のブログ投稿をご覧ください。

特徴 説明 発効日 その他の情報
コミッション入札戦略 Google Ads API では、 COMMISSION 入札戦略を使ったホテル キャンペーンの作成はサポートされなくなりました 。 2024 年 4 月 30 日 新しいホテル キャンペーンの作成、または COMMISSION 入札戦略を既存のキャンペーンに適用するリクエストでは、BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED エラーが発生します。「COMMISSION」入札戦略を使用している既存のキャンペーンは、2024 年 10 月 31 日まで引き続き実施されます。この日を過ぎると、入札戦略が更新されるまでキャンペーンの配信は停止されます。