サポートの終了と廃止

新しいバージョンのリリースに伴い、サポートが終了したバージョンに廃止日が設定され、その日以降は利用できなくなります。その他に注意すべきガイドラインは次のとおりです。

  • 一度に使用できるメジャー バージョンは 3 つまでです。
  • メジャー バージョンの有効期間は約 12 か月、マイナー バージョンの有効期間は 10 か月です。
  • 1 年間に 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 月 24 日 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.v17.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 バージョンがサポートされなくなりました。
サポート Google では、非推奨バージョンに対する定期的なサポートを提供しています。 廃止バージョンは、廃止日を過ぎるとサポートされなくなります。

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

以下の表は、どのクライアント ライブラリがどの API バージョンと連携するかを示しています。

Java

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

C#

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

PHP

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

Python

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

Ruby

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

Perl

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

機能の非推奨

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

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

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