新推出的版本中已淘汰 已訂定停用日期,該日期過後,該版本就會無法使用 廣告。以下是另外幾項需要注意的準則:
- 一次最多會有三個主要版本。
- 主要版本的效期約為 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 年 6 月 5 日 | 2025 年 1 月 | 從 v16 升級至 v17 |
v16 | 2024 年 2 月 21 日 | 2024 年 6 月 5 日 | 2025 年 1 月 | 從 v16 升級至 v17 |
v15 | 2023 年 10 月 18 日 | 2024 年 2 月 21 日 | 2024 年 9 月 25 日 | 從 v15 升級至 v16 |
查看專案目前使用的版本
您可以查看專案最近呼叫的方法和服務清單 使用 Google Cloud 控制台:
- 開啟 API 與 「服務」。
- 按一下表格中的「Google Ads API」。
- 「指標」子分頁應該會顯示您最近的要求,
每個圖表您可以在「
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 版本 排除日期這有助於在整合文件時節省空間 建立 Deployment 資訊清單 | 用戶端程式庫不再支援舊版 API 的 任何新的用戶端程式庫版本 |
支援 | 我們會定期為已淘汰的版本提供支援。 | 服務終止後不再支援淘汰版本 日期。 |
支援的用戶端程式庫版本
下表列出可與哪些 API 版本搭配使用的用戶端程式庫。
Java
Google Ads API |
適用於 Java 的用戶端程式庫 |
v17 |
Min: 32.0.0 Max:: |
v16 |
Min: 30.0.0 Max:: |
v15 |
Min: 28.0.0 Max: 32.0.0 |
C#
Google Ads API |
.NET 專用的用戶端程式庫 |
v17 |
Min: 20.1.0 Max:: |
v16 |
Min: 18.1.0 Max:: |
v15 |
Min: 17.1.0 Max: 20.1.0 |
PHP
Google Ads API |
PHP 適用的用戶端程式庫 |
v17 |
Min: 23.1.0 Max:: |
v16 |
Min: 22.1.0 Max:: |
v15 |
Min: 21.1.0 Max: 23.1.0
|
Python
Google Ads API |
Python 專用的用戶端程式庫 |
v17 |
Min: 24.1.0 Max:: |
v16 |
Min: 23.1.0 Max:: |
v15 |
Min: 22.1.0 Max:: |
小茹
Google Ads API |
Ruby 適用的用戶端程式庫 |
v17 |
Min: 29.0.0 Max:: |
v16 |
Min: 27.0.0 Max:: |
v15 |
Min: 25.0.0 Max:: |
Perl
Google Ads API |
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 日今天過後
廣告活動會停止放送,直到出價策略更新為止。
|