淘汰與停用

新推出的版本中已淘汰 已訂定停用日期，該日期過後，該版本就會無法使用 廣告。以下是另外幾項需要注意的準則：

  • 一次最多會有三個主要版本。
  • 主要版本的效期約為 12 個月 (次要版本)： 10 個月。
  • 每年最多只能執行兩次升級， 按照嚴格順序升級服務，例如 從 version (N) 直接轉換至 version (N+2)。
  • 所有用戶端程式庫推出後，與 新版本和停用時間至少為 20 週

我們的用戶端程式庫支援任何可用的 因此，您可以指定不同版本的 免費 Google Cloud 服務

時刻表

下表列出各 Google 服務的具體淘汰日期和停用日期 可用的版本和未來版本的預計發布日期三 建議您在 SDK 推出後盡快升級至最新版本 版本。

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

查看專案目前使用的版本

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

  1. 開啟 API 與 「服務」。
  2. 按一下表格中的「Google Ads API」。
  3. 「指標」METRICS子分頁應該會顯示您最近的要求， 每個圖表您可以在「 Methods 資料表。方法名稱 包含 Google Ads API 版本、服務和方法名稱，例如 google.ads.googleads.v17.services.GoogleAdsService.Mutate。
  4. (選用) 選擇要查看要求的時間範圍。

淘汰與停用之間的差異

字詞淘汰日落時刻
定義 已淘汰的版本不是最新版本。 新版本推出後，系統會將先前所有版本標示為 已淘汰 無法再使用終止版本。傳送要求給此項目 版本會在服務終止日期當天或之後失效。
影響 您仍然可以使用已淘汰的版本，直到停用為止。 但如果是取代已淘汰版本的參考資料，系統會以醒目方式顯示 已經不是最新版本

建議您盡快升級至最新版本， 享受新功能的種種好處

您需要立即在 才能使用 Google Ads API。

強烈建議您升級至 版本，請參閱升級指南。

時間 平均來說，我們每 3 到 4 個月會推出新版本，因此 版本將於約 3 到 4 個月後淘汰。 我們的目標是在版本推出 1 年後停用。
API 已淘汰版本的 API 端點仍能正常運作 。

您可以透過我們的用戶端程式庫、REST 等等， 開啟；但淘汰版本不會添加新功能。

停用版本的 API 端點會在日期後停止運作 日落日期。如果您嘗試存取 停用版本的 API 端點。
用戶端程式庫 為了提供精簡的用戶端程式庫，我們會停止 包括在新的用戶端程式庫版本中淘汰的 API 版本 排除日期這有助於在整合文件時節省空間 建立 Deployment 資訊清單 用戶端程式庫不再支援舊版 API 的 任何新的用戶端程式庫版本
支援 我們會定期為已淘汰的版本提供支援。 服務終止後不再支援淘汰版本 日期。

支援的用戶端程式庫版本

下表列出可與哪些 API 版本搭配使用的用戶端程式庫。

Java

適用於 Java 的用戶端程式庫
v17 Min: 32.0.0
Max:：
v16 Min: 30.0.0
Max:：
v15 Min: 28.0.0
Max: 32.0.0

C#

.NET 專用的用戶端程式庫
v17 Min: 20.1.0
Max:：
v16 Min: 18.1.0
Max:：
v15 Min: 17.1.0
Max: 20.1.0

PHP

PHP 適用的用戶端程式庫
v17 Min: 23.1.0
Max:：
v16 Min: 22.1.0
Max:：
v15 Min: 21.1.0
Max: 23.1.0

Python

Python 專用的用戶端程式庫
v17 Min: 24.1.0
Max:：
v16 Min: 23.1.0
Max:：
v15 Min: 22.1.0
Max:：

小茹

Ruby 適用的用戶端程式庫
v17 Min: 29.0.0
Max:：
v16 Min: 27.0.0
Max:：
v15 Min: 25.0.0
Max:：

Perl

Perl 適用的用戶端程式庫
v17 Min: 23.0.0
Max:：
v16 Min: 21.0.0
Max:：
v15 Min: 19.0.0
Max:：

淘汰功能

定期監控 Google Ads 開發人員網誌 搶先掌握即將淘汰的功能

下表列出了目前有哪些淘汰功能。 Google Ads API 的最新異動請參閱各項淘汰項目的詳細資訊 相關網誌文章

功能 說明 生效日期 其他注意事項
佣金出價策略 Google Ads API 不再支援使用「COMMISSION」建立飯店廣告活動 出價策略 。 2024 年 4 月 30 日 要求建立新飯店廣告活動或套用COMMISSION 出價策略對現有廣告活動的結果 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 錯誤。採用COMMISSION出價的現有廣告活動 策略會持續運作到 2024 年 10 月 31 日今天過後 廣告活動會停止放送，直到出價策略更新為止。