隨著新的版本推出，已淘汰的版本會指定為停用日期，之後該版本將無法再使用。以下是另外幾項需要注意的準則：
- 一次最多會有三個主要版本。
- 主要版本的效期約為 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 月 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」。
- 在「METRICS」子分頁中，您應該會在每張圖表中看見最近收到的要求。您可以在「Methods」表格中查看已接收要求的方法。方法名稱包含 Google Ads API 版本、服務和方法名稱 (例如
google.ads.googleads.v17.services.GoogleAdsService.Mutate)。 - (選用) 選擇要查看要求的時間範圍。
淘汰與停用之間的差異
| 字詞 | 淘汰 | 日落時刻 |
|---|---|---|
| 定義 | 已淘汰的版本不是最新版本。新版本推出後，先前所有版本都會標示為「已淘汰」。 | 無法再使用終止版本。自停用日期當天或之後，傳送至這個版本的要求就會失敗。 |
| 影響 | 在停用之前，您還是可以使用已淘汰的版本，但系統會取消醒目顯示已淘汰版本的參考資料，指出這些版本已不再是最新版本。 建議您盡快升級至最新版本，以便享有新功能帶來的福利。 |
您需要立即從停用版本升級，
才能使用 Google Ads API。
我們強烈建議依據升級指南升級到最新版本。 |
| 時間 | 我們平均每 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: 30.0.0
|
C#
Google Ads API |
適用於 .NET 的用戶端程式庫 |
v16 |
Min: 18.1.0Max: - |
v15 |
Min: 17.1.0Max: - |
v14 |
Min: 16.1.0Max: 19.0.1 |
PHP
Google Ads API |
PHP 適用的用戶端程式庫 |
v16 |
Min: 22.1.0Max: - |
v15 |
Min: 21.1.0Max: - |
Python
Google Ads API |
適用於 Python 的用戶端程式庫 |
v16 |
Min: 23.1.0Max: - |
v15 |
Min: 22.1.0Max: - |
小茹
Google Ads API |
Ruby 適用的用戶端程式庫 |
v16 |
Min: 27.0.0Max: - |
v15 |
Min: 25.0.0Max: - |
v14 |
Min: 23.0.0Max: 27.0.0
|
Perl
Google Ads API |
Perl 適用的用戶端程式庫 |
v16 |
Min: 21.0.0Max: - |
v15 |
Min: 19.0.0Max: - |
v14 |
Min: 17.0.0Max: 21.0.0 |
淘汰功能
請定期查看 Google Ads 開發人員網誌，搶先瞭解即將淘汰的功能。
下表列出了 Google Ads API 目前預計淘汰的特定功能。如要進一步瞭解各項淘汰措施，請參閱連結的網誌文章。
| 特徵 | 說明 | 生效日期 | 其他注意事項 |
|---|---|---|---|
| 佣金出價策略 |
Google Ads API
不再支援使用「COMMISSION」出價策略建立飯店廣告活動
。 |
2024 年 4 月 30 日 |
如果您要求建立新的飯店廣告活動，或為現有廣告活動套用「COMMISSION」出價策略，會導致 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 錯誤。採用「COMMISSION」出價策略的現有廣告活動將持續放送到 2024 年 10 月 31 日，否則廣告活動會停止放送，直到出價策略更新為止。
|