サポート終了と廃止

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

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

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

時刻表

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

API のバージョン	リリース日	廃止日	アップグレード ガイド
リリース バージョン
v21	2025 年 8 月 6 日	2026 年 8 月（予定）	v20 から v21 にアップグレードする
v22	2025 年 10 月 15 日	2026 年 10 月（予定）	v21 から v22 にアップグレードする
v23	2026 年 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 バージョンで動作するかを示します。

記載されている最小クライアント ライブラリ バージョンは、Google Ads API のメジャー リリース（v24 など）で十分です。マイナー リリースに必要なクライアント ライブラリのバージョンについては、リンク先の変更ログをご覧ください。

機能の非推奨と変更

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

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

機能	説明	発効日	その他の注意事項
データ保持ポリシーの変更	詳細なレポートデータ（日別、時間別、週別）の保持期間が 37 か月に短縮されます。対象期間が長いデータ（月 / 四半期 / 年単位）は 11 年間利用可能です。11 年間の保持は、完全な暦期間の境界（次の完全な期間の開始）に沿って行われます。次に例を示します。 11 年前が 2022 年 3 月 22 日の場合、2022 年 4 月 1 日から現在までのデータが返されます。 11 年前が 2022 年 3 月 1 日の場合、2022 年 4 月 1 日から現在までのデータが返されます。	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 を使用する必要があります。 2025 年 10 月 1 日から 2026 年 3 月 31 日までの間に、開発者トークンからカスタマー マッチのユーザーリストに対する OfflineUserDataJobService または UserDataService リクエストが送信された場合、Google Ads API でカスタマー マッチのワークフローに引き続き開発者トークンを使用できます。ただし、デベロッパー様のエクスペリエンスを向上させ、追加機能にアクセスできるようにするため、カスタマー マッチのワークフローを Data Manager API にアップグレードすることをおすすめします。 それ以外の場合、2026 年 4 月 1 日以降、顧客一致のユーザーリストに対する OfflineUserDataJobService または UserDataService リクエストは CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE エラーで失敗します。Google Ads API ではなく、カスタマー マッチのワークフローに Data Manager API を使用します。	2026 年 4 月 1 日	詳しくは、こちらのブログ投稿をご覧ください。
IP アドレスとセッション属性のサポートの変更	Google Ads API では、セッション属性や IP アドレスのデータを新たにコンバージョン インポートに含めることができなくなりました。既存のユーザーは Data Manager API に移行する必要があります。	2026 年 2 月 2 日	詳しくは、こちらのブログ投稿をご覧ください。
電話専用広告のサポート終了	新しい電話専用広告は作成できません。既存の電話専用広告は 2027 年 2 月に配信が停止され、API サポートも終了します。広告主様は、代わりに電話番号アセット付きのレスポンシブ検索広告をご利用ください。	2026 年 1 月	詳しくは、こちらのブログ投稿をご覧ください。