隨著新的版本推出,已淘汰的版本會指定為停用日期,之後該版本將無法再使用。以下是另外幾項需要注意的準則:
- 一次最多會有三個主要版本。
- 主要版本的效期約為 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 升級至 v16 |
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.v17.services.GoogleAdsService.Mutate
)。 - (選用) 選擇要查看要求的時間範圍。
淘汰與停用之間的差異
字詞 | 淘汰 | 日落時刻 |
---|---|---|
定義 | 已淘汰的版本不是最新版本。新版本推出後,先前所有版本都會標示為「已淘汰」。 | 無法再使用終止版本。自停用日期當天或之後,傳送至這個版本的要求就會失敗。 |
影響 | 在停用之前,您還是可以使用已淘汰的版本,但系統會取消醒目顯示已淘汰版本的參考資料,指出這些版本已不再是最新版本。 建議您盡快升級至最新版本,以便享有新功能帶來的福利。 |
您需要立即從停用版本升級,
才能使用 Google Ads API。
我們強烈建議依據升級指南升級到最新版本。 |
時間 | 我們平均每 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: - |
小茹
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 日,否則廣告活動會停止放送,直到出價策略更新為止。
|