淘汰與停用

發布新版本後，系統會為已淘汰版本設定服務終止日期，屆時該版本將無法再使用。請注意以下其他準則：

  • 我們盡量維持最多四個主要版本。
  • 主要版本的效期約為 12 個月，次要版本則為 10 個月。
  • 您每年最多只能升級兩次，而且不必依序升級，例如可以直接從版本 (N) 升級至版本 (N+2)。
  • 最新版本的所有用戶端程式庫發布日期，與即將淘汰的版本之間，至少有 20 週的重疊期。

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

時刻表

下表列出各個可用版本的確切淘汰和停止支援日期，以及未來版本的預計發布日期。建議您在最新版本發布後，盡快升級至最新版本。暫定日期表示該月隨時可能終止服務，且日期可能會變更。 訂閱網誌，接收 API 版本淘汰公告提醒。

API 版本發布日期淘汰日期服務終止日期升級指南
v212025 年 8 月 6 日從 v20 升級至 v21
v20.12025 年 8 月 6 日2026 年 6 月 (暫定)從第 19 版升級至第 20 版
v202025 年 6 月 4 日2026 年 6 月 (暫定)從第 19 版升級至第 20 版
v19.22025 年 8 月 6 日2026 年 2 月 (暫定)從第 18 版升級至第 19 版
v19.12025 年 4 月 16 日2026 年 2 月 (暫定)從第 18 版升級至第 19 版
v192025 年 2 月 26 日2026 年 2 月 (暫定)從第 18 版升級至第 19 版
v182024 年 10 月 16 日2025 年 6 月2025 年 8 月 20 日

查看專案使用的版本

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

  1. 在 Google Cloud 控制台中開啟「APIs & Services」(API 和服務)。
  2. 按一下表格中的「Google Ads API」。
  3. 在「指標」子分頁中，您應該會看到每個圖表上繪製的近期要求。您可以在「方法」表格中，查看您已傳送要求的方法。方法名稱包含 Google Ads API 版本、服務和方法名稱，例如 google.ads.googleads.v21.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 的用戶端程式庫
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#

.NET 專用的用戶端程式庫
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

PHP 用戶端程式庫
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

Python

Python 專用的用戶端程式庫
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

小茹

Ruby 適用的用戶端程式庫
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

Perl 適用的用戶端程式庫
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

淘汰功能

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

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

功能 說明 生效日期 其他注意事項
轉換環境會影響應用程式廣告活動成效 自 2025 年 9 月 30 日起，我們將逐步推出出價模式變更，讓出價模式能使用匯入轉換中包含的轉換環境資料，盡可能提升廣告活動成效。 2025 年 10 月 3 日 詳情請參閱這篇網誌文章。
轉換可以同時包含 `gclid` 和 `gbraid` 值。 自 2025 年 10 月 3 日起，如果同時設定 `gclid` 和 `gbraid` 欄位，匯入的轉換就不會再傳回 `VALUE_MUST_BE_UNSET` 錯誤。 2025 年 10 月 3 日 詳情請參閱這篇網誌文章。