新しいバージョンのリリースに伴い、サポートが終了したバージョンに廃止日が設定され、その日以降は利用できなくなります。その他に注意すべきガイドラインは次のとおりです。
- 一度に使用できるメジャー バージョンは 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 コンソールを使用して、プロジェクトで最近呼び出されたメソッドとサービスのリストを表示できます。
- Google Cloud コンソールで [API とサービス] を開きます。
- 表内の [Google Ads API] をクリックします。
- [指標] サブタブで、各グラフに最近のリクエストがプロットされたことがわかります。リクエストを送信したメソッドは、[メソッド] テーブルで確認できます。メソッド名には、Google Ads API のバージョン、サービス、メソッド名が含まれます(例:
google.ads.googleads.v17.services.GoogleAdsService.Mutate
)。 - (省略可)リクエストを表示する期間を選択します。
「サポート終了」と「廃止」の違い
用語 | 非推奨 | 夕暮れ |
---|---|---|
定義 | 非推奨バージョンは最新ではありません。 新しいバージョンがリリースされると、以前のバージョンはすべて非推奨としてマークされます。 | 廃止バージョンはご利用いただけなくなりました。このバージョンに送信されたリクエストは、廃止日以降は失敗します。 |
意味 | 非推奨バージョンは廃止されるまで引き続き使用できますが、非推奨バージョンへの参照はハイライト表示され、最新バージョンではないことが示されます。
新機能を活用するために、できるだけ早く最新バージョンにアップグレードすることをおすすめします。 |
Google Ads API を使用するには、廃止対象バージョンから直ちにアップグレードする必要があります。
アップグレード ガイドを参照して、最新バージョンにアップグレードすることを強くおすすめします。 |
時間配分 | 新バージョンは平均で 3 ~ 4 か月ごとにリリースされるため、このバージョンは約 3 ~ 4 か月後にサポートが終了します。 | バージョンは、リリースから 1 年後に廃止することを目指しています。 |
API | 非推奨バージョンの API エンドポイントは、引き続き通常どおり機能します。 Google のクライアント ライブラリや REST などを使用して API エンドポイントにアクセスできます。ただし、非推奨バージョンには新機能が追加されていません。 |
廃止バージョンの API エンドポイントは、廃止日を過ぎると機能しなくなります。廃止バージョンの API エンドポイントにアクセスしようとすると、Google Ads API からエラーがスローされます。 |
クライアント ライブラリ | コンパクトなクライアント ライブラリを提供するため、サポート終了日以降は、新しいクライアント ライブラリ バージョンには非推奨の API バージョンが含まれなくなります。これにより、プロジェクトに Google のクライアント ライブラリを組み込む際のスペースを節約できます。 | クライアント ライブラリでは、廃止日をすぎると、新しいクライアント ライブラリのバージョンでは廃止された API バージョンがサポートされなくなりました。 |
サポート | Google では、非推奨バージョンに対する定期的なサポートを提供しています。 | 廃止バージョンは、廃止日を過ぎるとサポートされなくなります。 |
サポートされているクライアント ライブラリのバージョン
以下の表は、どのクライアント ライブラリがどの API バージョンと連携するかを示しています。
Java
Google Ads API |
Java 用のクライアント ライブラリ |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
.NET 用のクライアント ライブラリ |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: 19.0.1 |
PHP
Google Ads API |
PHP 用クライアント ライブラリ |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
Python
Google Ads API |
Python 用のクライアント ライブラリ |
v16 |
Min: 23.1.0 Max: - |
v15 |
Min: 22.1.0 Max: - |
Ruby
Google Ads API |
Ruby 用クライアント ライブラリ |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
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 日まで引き続き実施されます。この日を過ぎると、入札戦略が更新されるまでキャンペーンの配信は停止されます。
|