淘汰與停用

新版本發布後，已淘汰的版本會獲得服務終止日期，之後該版本將無法再使用。以下是其他注意事項：

  • 我們致力於確保任何時候最多有五個主要版本可供使用。
  • 主要版本的生命週期約為 12 個月，次要版本則為 10 個月。
  • 您每年最多只需升級兩次，且不必嚴格按照順序升級，例如可以直接從版本 (N) 升級至版本 (N+2)。

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

時刻表

下表列出各個可用版本的具體淘汰和停用日期，以及未來版本的預計發布日期。建議您在最新版本發布後，盡快升級。暫定日期表示停用時間可能在該月的任何一天，且日期可能變更。訂閱網誌，接收 API 版本停用公告提醒。

API 版本 發布日期 服務終止日期 破壞性變更和升級 功能與更新 Proto 差異表
已發布版本
v23 2026 年 1 月 28 日 2027 年 2 月 v23 破壞性變更 (升級指南) v23 功能和更新 v22 與 v23 原型差異
v23.1 2026 年 2 月 25 日 2027 年 2 月 無 (次要版本) v23.1 功能和更新 v22 與 v23 原型差異
v23.2 2026 年 3 月 25 日 2027 年 2 月 無 (次要版本) v23.2 功能和更新 v22 與 v23 原型差異
v23.3 2026 年 6 月 24 日 2027 年 2 月 無 (次要版本) v23.3 功能和更新 v22 與 v23 原型差異
v24 2026 年 4 月 22 日 2027 年 5 月 v24 破壞性變更 (升級指南) 第 24 版功能和更新 v23 與 v24 proto 差異
v24.1 2026 年 5 月 13 日 2027 年 5 月 無 (次要版本) v24.1 功能和更新 v23 與 v24 proto 差異
v24.2 2026 年 6 月 24 日 2027 年 6 月 無 (次要版本) v24.2 功能和更新 v23 與 v24 proto 差異
v25 2026 年 7 月 22 日 2027 年 8 月 v25 破壞性變更 (升級指南) v25 功能和更新 v24 與 v25 的原型差異
v25.1 2026 年 8 月 19 日 2027 年 8 月 無 (次要版本) v25.1 功能和更新 v24 與 v25 的原型差異
v25.2 2026 年 9 月 23 日 2027 年 8 月 無 (次要版本) 25.2 版功能和更新 v24 與 v25 的原型差異
v26 (最新) 2026 年 10 月 14 日 2027 年 11 月 v26 破壞性變更 (升級指南) v26 功能和更新 v25 與 v26 原型差異
即將推出的版本
v26.1 2026 年 10 月 2027 年 11 月      
v26.2 2026 年 11 月 2027 年 11 月      
v26.3* 2026 年 12 月 2027 年 11 月      
v27 2027 年 1 月 2028 年 2 月      
v27.1 2027 年 2 月 2028 年 2 月      
v27.2 2027 年 2 月 2028 年 2 月      
v27.3 2027 年 3 月 2028 年 2 月      
v27.4 2027 年 3 月 2028 年 2 月      
v28 2027 年 4 月 2028 年 5 月      
v28.1 2027 年 4 月 2028 年 5 月      
v28.2 2027 年 5 月 2028 年 5 月      
v28.3 2027 年 5 月 2028 年 5 月      
v28.4 2027 年 6 月 2028 年 5 月      
v28.5 2027 年 6 月 2028 年 5 月      
v29 2027 年 7 月 2028 年 8 月      
v29.1 2027 年 7 月 2028 年 8 月      
v29.2 2027 年 8 月 2028 年 8 月      
v29.3 2027 年 8 月 2028 年 8 月      
v29.4 2027 年 9 月 2028 年 8 月      
v29.5 2027 年 9 月 2028 年 8 月      
v30 2027 年 10 月 2028 年 11 月      
v30.1 2027 年 10 月 2028 年 11 月      
v30.2 2027 年 11 月 2028 年 11 月      
v30.3* 2027 年 12 月 2028 年 11 月      

* 由於與節慶季節重疊，v26.3 和 v30.3 指定為選用版本。

查看專案使用的版本

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

  1. 在 Google Cloud 控制台中，開啟「APIs & Services」(API 和服務)。
  2. 按一下表格中的「Google Ads API」。
  3. 在「METRICS」(指標) 子分頁中，您應該會看到每張圖表上都繪製了最近的要求。您可以在「Methods」(方法) 表格中，查看您傳送要求的目標方法。方法名稱包含 Google Ads API 版本、服務和方法名稱，例如 google.ads.googleads.v26.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 主要版本 (例如 v26)。如要查看次要版本所需的用戶端程式庫版本，請參閱連結的變更記錄。

Java

變更記錄

適用於 Java 的用戶端程式庫
v26 Min: 48.0.0
Max: -
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

變更記錄

.NET 專用的用戶端程式庫
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

變更記錄

PHP 用戶端程式庫
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

變更記錄

Python 專用的用戶端程式庫
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

小茹

變更記錄

Ruby 用戶端程式庫
v26 Min: 46.0.0
Max: -
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

變更記錄

Perl 用戶端程式庫
v26 Min: 36.0.0
Max: -
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

功能淘汰和異動

雖然本頁面著重於 API 版本層級的生命週期，但個別功能淘汰 (例如淘汰智慧廣告活動) 和無版本工作流程變更 (例如新的需求開發廣告活動預算規定) 會分開追蹤。

如要查看各個有效版本即將推出的功能生命週期和行為改變，請參閱「功能淘汰和無版本異動」指南。