サポート終了と廃止

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

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

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

時刻表

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

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

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

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

  1. Google Cloud コンソールで [API とサービス] を開きます。
  2. 表で [Google Ads API] をクリックします。
  3. [指標] サブタブに、各グラフに最近のリクエストが表示されます。リクエストを送信したメソッドは、[メソッド] テーブルで確認できます。メソッド名には、Google Ads API のバージョン、サービス、メソッド名（google.ads.googleads.v19.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 バージョンに対応しているかを示します。

JavaC#PHPPythonRubyPerl
Java 用のクライアント ライブラリ
v19 Min: 36.0.0
Max: -
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
.NET 用のクライアント ライブラリ
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: 21.1.0
PHP 用クライアント ライブラリ
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
Python 用のクライアント ライブラリ
v19 Min: 25.2.0
Max: -
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -
Ruby 用クライアント ライブラリ
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -
Perl 用のクライアント ライブラリ
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: -
v17 Min: 23.0.0
Max: -

機能の非推奨

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

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

機能 説明 発効日 その他の情報
Google Ads API と Google 広告スクリプトの検索語句分析レポートの更新（2025 年 3 月 3 日より） 2025 年 3 月 3 日より、Google 広告 API と Google 広告スクリプトの検索語句分析レポートでは、すべての検索サブカテゴリが空として返されます。Google 広告の管理画面ではすでにこのフィールドが削除されており、Google 広告全体で整合性を確保するため、API でもこの変更がロールアウトされます。 2025 年 3 月 3 日 2025 年 3 月 3 日以降、 segments.search_subcategory の値はすべて空になります。 campaign_search_term_insight レポートまたは customer_search_term_insight レポートで segments.search_subcategory をクエリする場合は、コードが segments.search_subcategory の空の値を処理できることを確認します。空の文字列はすでにキャッチオールであるため、コードですでに処理されているはずです。クエリから segments.search_subcategory を削除することをおすすめします。
Google Ads API のページサイズに関する今後の変更 v16 のサポートが終了すると、GoogleAdsService.Search リクエストの送信時に page_size フィールドを設定できなくなります。 2025 年 2 月 v16 が廃止されると、すべての GoogleAdsService.Search リクエストで 10,000 行の固定ページサイズが前提となります。
カスタマー マッチ メンバーシップの有効期限に関する更新 2025 年 4 月 7 日より、UserList.membership_life_span フィールドで 540 を超える値を指定できなくなります。 2025 年 4 月 7 日 2025 年 4 月 7 日から 2025 年 4 月 15 日にかけて、UserList.membership_life_span フィールドの変更が段階的にロールアウトされます。フィールドを 540 より大きく設定するリクエストは、RangeError.TOO_HIGH エラーを返します。フィールド値が 540 より大きい既存のユーザーリストは、メンバーシップの有効期間が最大 540 日になるように自動的に移行されます。詳しくは、カスタマー マッチ メンバーシップの有効期限に関する更新をご覧ください。