サポート終了と廃止

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

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

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

時刻表

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

API のバージョンリリース日サポート終了日廃止日アップグレード ガイド
v202025 年 6 月 4 日v19 から v20 へのアップグレード
v19.12025 年 4 月 16 日
v192025 年 2 月 26 日v18 から v19 へのアップグレード
v182024 年 10 月 16 日2025 年 6 月2025 年 8 月v17 から v18 へのアップグレード

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

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

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

非推奨と廃止の違い

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

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

 Google Ads API を使用するには、サポート終了バージョンから直ちにアップグレードする必要があります。

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

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

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

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

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

Java

Java 用のクライアント ライブラリ
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -
v18 Min: 34.0.0
Max: -
v17 Min: 31.0.0
Max: 36.1.0

C#

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

PHP

PHP 用クライアント ライブラリ
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: 27.2.0

Python

Python 用のクライアント ライブラリ
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: 26.1.0

Ruby

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

Perl

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

機能の非推奨

Google 広告デベロッパー ブログを定期的に確認して、今後非推奨になる機能についていち早く情報を入手してください。

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

機能 説明 発効日 その他の情報
無効な開発者トークンに関する新しいエラー メッセージ 2025 年 4 月 28 日以降、無効なデベロッパー トークンから、v19.1 以降では DEVELOPER_TOKEN_INVALID、v19.1 より前では DEVELOPER_TOKEN_NOT_APPROVED が返されます。無効なデベロッパー トークンは以前 OAUTH_TOKEN_HEADER_INVALID を返していましたが、これは引き続き無効な OAuth ヘッダーで使用されます。 2025 年 4 月 28 日 この変更は、すでに機能している API 呼び出しには影響しません。