推出新版本時，已淘汰的版本會給予終止日期，該日期過後就不會再提供使用。以下列出其他幾項規範：
- 最多同時提供三個主要版本。
- 主要版本的效期約為 12 個月 (次要版本)：10 個月。
- 您每年最多可執行兩次升級，而且沒有按照嚴格的順序升級，例如，您可以直接從版本 (N) 升級至版本 (N+2)。
- 以最新版所有用戶端程式庫發布，到即將停用版本的日期重疊，至少 20 週。
我們的用戶端程式庫支援任何可用的服務版本，因此您只要指定所用服務的不同版本，即可逐步升級。
時刻表
下表列出每個可用版本的特定淘汰和終止日期，以及未來版本的預計發布日期。建議您在新版本發布後盡快升級至最新版本。
| 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 月/5 月 | 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 升級至第 16 版 |
| 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」。
- 在「METRICS」子分頁中，每個圖表應該都會顯示最近的要求。您可以在「Methods」(方法) 表格中查看已傳送要求的方法。方法名稱包含 Google Ads API 版本、服務和方法名稱 (例如
google.ads.googleads.v16.services.GoogleAdsService.Mutate)。 - (選用) 選擇要查看要求的時間範圍。
淘汰與停用之間的差異
| 字詞 | 淘汰 | 日落時刻 |
|---|---|---|
| 定義 | 已淘汰版本是不是最新版本的版本。新版本發布後，系統會將先前所有版本標示為「已淘汰」。 | 停用版本無法再使用。自服務終止日期當天或之後，傳送至這個版本的要求將會失敗。 |
| 影響 | 您仍然可以使用已淘汰的版本，直到這些版本停用為止，但會停用已淘汰版本參照，指出這些版本已不再是最新版本。 建議您盡快升級至最新版本，以便享有新功能的優勢。 |
您必須立即從停用版本進行升級，才能使用 Google Ads API。 強烈建議您按照升級指南升級至最新版本。 |
| 時間 | 平均而言，Google 每 3 到 4 個月會發布新版本，因此指定的版本大約會在 3 到 4 個月後淘汰。 | 並預計在第 1 年發布後停用。 |
| API | 已淘汰版本的 API 端點仍會照常運作。 您可以使用我們的用戶端程式庫、REST 等方法存取 API 端點，但已淘汰的版本不會新增功能。 |
停用版本的 API 端點在停用日期過後會停止運作。如果您嘗試存取已停用版本的 API 端點，Google Ads API 就會擲回錯誤。 |
| 用戶端程式庫 | 為了提供精簡的用戶端程式庫，在淘汰日期後，我們將不再納入已淘汰的 API 版本。在專案中加入用戶端程式庫時，這個做法有助於節省空間。 | 合約終止日期過後，任何新版用戶端程式庫中不再支援的舊版 API 版本。 |
| 支援服務 | 我們會定期支援已淘汰的版本。 | 服務終止日期過後，不再支援停用版本。 |
支援的用戶端程式庫版本
下表列出可與各個 API 版本搭配使用的用戶端程式庫。
Java
Google Ads API |
適用於 Java 的用戶端程式庫 |
v16 |
Min: 30.0.0Max: - |
v15 |
Min: 28.0.0Max: - |
v14 |
Min: 26.0.0Max: - |
C#
Google Ads API |
適用於 .NET 的用戶端程式庫 |
v16 |
Min: 18.1.0Max: - |
v15 |
Min: 17.1.0Max: - |
v14 |
Min: 16.1.0Max: - |
PHP
Google Ads API |
PHP 適用的用戶端程式庫 |
v16 |
Min: 22.1.0Max: - |
v15 |
Min: 21.1.0Max: - |
v14 |
Min: 19.2.0Max: - |
Python
Google Ads API |
適用於 Python 的用戶端程式庫 |
v15 |
Min: 22.1.0Max: - |
v14 |
Min: 21.2.0Max: - |
Ruby
Google Ads API |
Ruby 適用的用戶端程式庫 |
v16 |
Min: 27.0.0Max: - |
v15 |
Min: 25.0.0Max: - |
v14 |
Min: 23.0.0Max: - |
Perl
Google Ads API |
Perl 的用戶端程式庫 |
v16 |
Min: 21.0.0Max: - |
v15 |
Min: 19.0.0Max: - |
v14 |
Min: 17.0.0Max: - |
淘汰功能
定期查看 Google Ads 開發人員網誌，搶先掌握即將淘汰的功能資訊。
下表列出目前預計針對 Google Ads API 推出的特定功能淘汰功能。如需每個淘汰作業的詳細資料，請參閱連結的網誌文章。
| 功能 | 說明 | 生效日期 | 其他注意事項 |
|---|---|---|---|
| 佣金出價策略 |
Google Ads API
不再支援使用COMMISSION出價策略
建立飯店廣告活動。 |
2024 年 4 月 30 日 |
要求建立新的飯店廣告活動，或將「COMMISSION」出價策略套用至現有廣告活動，將會導致 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 錯誤。採用「COMMISSION」出價策略的現有廣告活動將持續放送到 2024 年 10 月 31 日。當天過後，廣告活動就會停止放送，直到出價策略更新為止。 |