サポート終了と廃止

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

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

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

時刻表

次の表は、利用可能な各バージョンのサポート終了日と廃止日、および将来のバージョンのリリース予定日を示しています。リリース後、できるだけ早く最新バージョンにアップグレードすることをおすすめします。暫定的な日付は、その月の任意の時点で廃止される可能性があることを意味します。また、日付は変更される可能性があります。API バージョンの廃止に関するお知らせのリマインダーについては、ブログを購読してください。

API のバージョンリリース日廃止日アップグレード ガイド
リリース バージョン
v212025 年 8 月 6 日2026 年 8 月（予定）v20 から v21 にアップグレードする
v222025 年 10 月 15 日2026 年 10 月（予定）v21 から v22 にアップグレードする
v232026 年 1 月 28 日2027 年 2 月v22 から v23 にアップグレードする
v23.1 2026 年 2 月 25 日 2027 年 2 月 v23 から v23.1 へのアップグレード
v23.2 2026 年 3 月 25 日 2027 年 2 月 v23.1 から v23.2 へのアップグレード
v24 2026 年 4 月 22 日 2027 年 5 月 v23.2 から v24 へのアップグレード
v24.1 2026 年 5 月 13 日 2027 年 5 月 v24 から v24.1 へのアップグレード
今後のバージョン
v24.2 2026 年 6 月 2027 年 5 月  
v25 2026 年 7 月 2027 年 8 月  
v25.1 2026 年 8 月 2027 年 8 月  
v25.2 2026 年 9 月 2027 年 8 月  
v26 2026 年 10 月 2027 年 11 月  
v26.1* 2026 年 11 月 2027 年 11 月  

* v26.1 は、ホリデー シーズンと重複するため、オプション リリースとして指定されています。

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

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

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

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

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

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

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

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

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

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

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

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

Java

Java 用のクライアント ライブラリ
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -

C#

.NET 用のクライアント ライブラリ
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -

PHP

PHP 用クライアント ライブラリ
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -

Python

Python 用のクライアント ライブラリ
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -

Ruby

Ruby 用クライアント ライブラリ
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -

Perl

Perl 用のクライアント ライブラリ
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -

機能の非推奨

Google 広告デベロッパー ブログを定期的にチェックして、今後の機能の非推奨化に関する最新情報をいち早く入手してください。

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

機能 説明 発効日 その他の注意事項
データ保持ポリシーの変更 詳細なレポートデータ（日別、時間別、週別）の保持期間が 37 か月に短縮されます。対象期間が長いデータ（月 / 四半期 / 年単位）は 11 年間利用可能です。 2026 年 6 月 1 日 詳しくは、こちらのブログ投稿をご覧ください。
オフライン コンバージョン サポートの変更

2026 年 6 月 15 日以降、最近オフライン コンバージョン リクエストがないデベロッパー トークンは、オフライン コンバージョン ワークフローに Data Manager API を使用する必要があります。

  • デベロッパー トークンが 2025 年 12 月 17 日から 2026 年 6 月 15 日の間に UploadClickConversions リクエストを送信した場合、オフライン コンバージョン ワークフローで Google Ads API を使用してデベロッパー トークンを引き続き使用できます。ただし、デベロッパー エクスペリエンスの向上と追加機能へのアクセスを実現するため、オフライン コンバージョン ワークフローを Data Manager API にアップグレードすることをおすすめします。
  • それ以外の場合、2026 年 6 月 15 日以降、UploadClickConversions リクエストはエラー CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE で失敗します。Google Ads API ではなく、Data Manager API をオフライン コンバージョン ワークフローにご利用ください。
 2026 年 6 月 15 日 詳しくは、こちらのブログ投稿をご覧ください。
カスタマー マッチのサポートに関する変更

2026 年 4 月 1 日以降、最近カスタマー マッチ リクエストがないデベロッパー トークンは、カスタマー マッチ ワークフローに Data Manager API を使用する必要があります。

 2026 年 4 月 1 日 詳しくは、こちらのブログ投稿をご覧ください。
IP アドレスとセッション属性のサポートの変更 Google Ads API では、セッション属性や IP アドレスのデータを新たにコンバージョン インポートに含めることができなくなりました。既存のユーザーは Data Manager API に移行する必要があります。 2026 年 2 月 2 日 詳しくは、こちらのブログ投稿をご覧ください。
電話専用広告のサポート終了 新しい電話専用広告は作成できません。既存の電話専用広告は 2027 年 2 月に配信が停止され、API サポートも終了します。広告主様は、代わりに電話番号アセット付きのレスポンシブ検索広告をご利用ください。 2026 年 1 月 詳しくは、こちらのブログ投稿をご覧ください。