推出新版本時,已淘汰的版本會給予終止日期,該日期過後就不會再提供使用。以下列出其他幾項規範:
- 最多同時提供三個主要版本。
- 主要版本的效期約為 12 個月 (次要版本):10 個月。
- 您每年最多可執行兩次升級,而且沒有按照嚴格的順序升級,例如,您可以直接從版本 (N) 升級至版本 (N+2)。
- 以最新版所有用戶端程式庫發布,到即將停用版本的日期重疊,至少 20 週。
我們的用戶端程式庫支援任何可用的服務版本,因此您只要指定所用服務的不同版本,即可逐步升級。
時刻表
下表列出每個可用版本的特定淘汰和終止日期,以及未來版本的預計發布日期。建議您在新版本發布後盡快升級至最新版本。
API 版本 | 發行日期 | 淘汰日期 | 服務終止日期 | 升級指南 |
---|---|---|---|---|
v18 | 2024 年 9/10 月 | 2025 年 1 月/2 月 | 2025 年 9 月 | |
v17.1 | 2024 年 7 月/8 月 | 2024 年 9/10 月 | 2025 年 5 月 | |
v17 | 2024 年 5/6 月 | 2024 年 9/10 月 | 2025 年 5 月 | |
v16.1 | 2024 年 4 月 24 日 | 2024 年 5/6 月 | 2025 年 1 月 | |
v16 | 2024 年 2 月 21 日 | 2024 年 5/6 月 | 2025 年 1 月 | |
v15 | 2023 年 10 月 18 日 | 2024 年 2 月 21 日 | 2024 年 9 月 25 日 | 從 v15 升級至第 16 版 |
v14.1 | 2023 年 8 月 9 日 | 2023 年 10 月 18 日 | 2024 年 6 月 5 日 | |
v14 | 2023 年 6 月 7 日 | 2023 年 10 月 18 日 | 2024 年 6 月 5 日 | 從 v14 升級至 v15 |
查看專案目前使用的版本
您可以使用 Google Cloud 控制台,查看專案最近呼叫的方法和服務清單:
- 在 Google Cloud 控制台中開啟「API 和服務」。
- 按一下表格中的「Google Ads API」。
- 在「METRICS」子分頁中,每個圖表應該都會顯示最近的要求。您可以在「Methods」(方法) 表格中查看已傳送要求的方法。方法名稱包含 Google Ads API 版本、服務和方法名稱 (例如
google.ads.googleads.v16.services.GoogleAdsService.Mutate
)。 - (選用) 選擇要查看要求的時間範圍。
淘汰與停用之間的差異
字詞 | 淘汰 | 日落時刻 |
---|---|---|
定義 | 已淘汰版本是不是最新版本的版本。新版本發布後,系統會將先前所有版本標示為「已淘汰」。 | 停用版本無法再使用。自服務終止日期當天或之後,傳送至這個版本的要求將會失敗。 |
影響 | 您仍然可以使用已淘汰的版本,直到這些版本停用為止,但會停用已淘汰版本參照,指出這些版本已不再是最新版本。 建議您盡快升級至最新版本,以便享有新功能的優勢。 |
您必須立即從停用版本進行升級,才能使用 Google Ads API。 強烈建議您按照升級指南升級至最新版本。 |
時間 | 平均而言,Google 每 3 到 4 個月會發布新版本,因此指定的版本大約會在 3 到 4 個月後淘汰。 | 並預計在第 1 年發布後停用。 |
API | 已淘汰版本的 API 端點仍會照常運作。 您可以使用我們的用戶端程式庫、REST 等方法存取 API 端點,但已淘汰的版本不會新增功能。 |
停用版本的 API 端點在停用日期過後會停止運作。如果您嘗試存取已停用版本的 API 端點,Google Ads API 就會擲回錯誤。 |
用戶端程式庫 | 為了提供精簡的用戶端程式庫,在淘汰日期後,我們將不再納入已淘汰的 API 版本。在專案中加入用戶端程式庫時,這個做法有助於節省空間。 | 合約終止日期過後,任何新版用戶端程式庫中不再支援的舊版 API 版本。 |
支援服務 | 我們會定期支援已淘汰的版本。 | 服務終止日期過後,不再支援停用版本。 |
支援的用戶端程式庫版本
下表列出可與各個 API 版本搭配使用的用戶端程式庫。
Java
Google Ads API |
適用於 Java 的用戶端程式庫 |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
適用於 .NET 的用戶端程式庫 |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: 19.0.1 |
PHP
Google Ads API |
PHP 適用的用戶端程式庫 |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
Python
Google Ads API |
適用於 Python 的用戶端程式庫 |
v16 |
Min: 23.1.0 Max: - |
v15 |
Min: 22.1.0 Max: - |
Ruby
Google Ads API |
Ruby 適用的用戶端程式庫 |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
Perl 的用戶端程式庫 |
v16 |
Min: 21.0.0 Max: - |
v15 |
Min: 19.0.0 Max: - |
v14 |
Min: 17.0.0 Max: 21.0.0 |
淘汰功能
定期查看 Google Ads 開發人員網誌,搶先掌握即將淘汰的功能資訊。
下表列出目前預計針對 Google Ads API 推出的特定功能淘汰功能。如需每個淘汰作業的詳細資料,請參閱連結的網誌文章。
功能 | 說明 | 生效日期 | 其他注意事項 |
---|---|---|---|
佣金出價策略 |
Google Ads API
不再支援使用COMMISSION 出價策略
建立飯店廣告活動。 |
2024 年 4 月 30 日 |
要求建立新的飯店廣告活動,或將「COMMISSION 」出價策略套用至現有廣告活動,將會導致 BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED 錯誤。採用「COMMISSION 」出價策略的現有廣告活動將持續放送到 2024 年 10 月 31 日。當天過後,廣告活動就會停止放送,直到出價策略更新為止。 |