淘汰與停用

隨著新的版本推出，已淘汰的版本會指定為停用日期，之後該版本將無法再使用。請注意以下其他規範：

  • 一次最多會有三個主要版本。
  • 主要版本的生命週期約為 12 個月，次要版本則為 10 個月。
  • 您每年最多必須執行兩次升級，且不需要按照嚴格的順序升級，例如直接從版本 (N) 升級至版本 (N+2)。
  • 所有用戶端程式庫發布最新版本與停用的版本之間，至少有 20 週的時間重疊。

我們的用戶端程式庫支援任何可用服務版本，因此您可以指定使用的服務不同版本來逐步升級。

時刻表

下表列出各個可用版本的具體淘汰和停用日期，以及未來版本的預估發布日期。建議您在最新版本推出後盡快升級。

API 版本 發布日期 淘汰日期 服務終止日期 升級指南
v18 2024 年 10 月 16 日 2025 年 2 月 2025 年 9 月 24 日
17.1 版 2024 年 8 月 7 日 2024 年 9 月/10 月 2025 年 6 月 4 日 從 v17 升級至 v18
v17 2024 年 6 月 5 日 2024 年 9 月/10 月 2025 年 6 月 4 日 從 v17 升級至 v18
v16.1 2024 年 4 月 24 日 2024 年 6 月 5 日 2025 年 2 月 5 日 從 v16 升級至 v17
v16 2024 年 2 月 21 日 2024 年 6 月 5 日 2025 年 2 月 5 日 從 v16 升級至 v17

查看專案目前使用的版本

您可以使用 Google Cloud 控制台，查看專案最近呼叫的方法和服務清單：

  1. 在 Google Cloud 控制台中開啟「API 和服務」。
  2. 按一下表格中的「Google Ads API」。
  3. 在「METRICS」METRICS子分頁中，您應該會在每張圖表中看見最近收到的要求。您可以在「方法」表格中查看已傳送要求的對象。方法名稱包含 Google Ads API 版本、服務和方法名稱，例如 google.ads.googleads.v18.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 的用戶端程式庫
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: -

C#

.NET 專用的用戶端程式庫
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: -

PHP

PHP 適用的用戶端程式庫
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

Python 專用的用戶端程式庫
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

小茹

Ruby 適用的用戶端程式庫
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

適用於 Perl 的用戶端程式庫
v18 Min: 25.0.0
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -

淘汰功能

請定期查看 Google Ads 開發人員網誌，搶先瞭解即將淘汰的功能。

下表列出 Google Ads API 目前計畫淘汰的特定功能。如要進一步瞭解各項淘汰作業，請參閱連結網誌文章。

功能 說明 生效日期 其他注意事項
Google Ads API 中的頁面大小近期異動 當 v16 停止服務時，您將無法再在提出 GoogleAdsService.Search 要求時設定 page_size 欄位。 2025 年 1 月 當 v16 停止提供時，所有 GoogleAdsService.Search 要求會假設頁面大小為 10,000 列。
成本效益管理系統出價策略 Google Ads API 已不再支援為搜尋和多媒體廣告活動設定成本效益管理系統做為出價策略。 2024 年 10 月 在出價策略中將 enhanced_cpc_enabled 欄位設為 TRUE 的請求會導致 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 錯誤。採用成本效益管理系統出價策略的現有廣告活動將持續放送至 2025 年 3 月 15 日。否則會自動改為「手動單次點擊出價」。