語意版本管理
Google Ads API 遵循語意化版本管理,其中包含主要和子版本。版本格式為 MAJOR.MINOR
或 vMAJOR_MINOR
,舉例來說,v17_0
是主要版本,v17_1
則是子版本。
如要查看過往版本的版本資訊,
主要版本
主要發布版本有些破壞性和回溯不相容的變更。版本會以零的結尾 (格式為 vX_0
),其中 X
是主要版本號碼。
每個主要版本都有單獨的端點。以下是網址範例,其中 X
是主要版本號碼。
https://googleads.googleapis.com/vX
如果您是從舊的主要版本升級,則切換至新的主要版本端點時,程式碼可能需要變更。如果您使用用戶端程式庫,請升級至最新版本。有主要版本發布時,我們會提供遷移指南,引導您修正程式碼的任何破壞性變更。
破壞性變更的例子包括:
- 移除或重新命名服務、介面、欄位、方法或列舉值。
- 變更欄位類型。
- 變更資源名稱格式。
- 變更 HTTP 定義中的網址格式。
- 變更輸出格式,例如從
0
變更為--
為預設值。 - 變更從 A 傳回的錯誤原因。
子版本
子版本只會推出回溯相容的變更。如果是子版本,vMAJOR_MINOR
的 MINOR
數字會大於零。
發布子版本時,系統會自動更新已在使用中的端點。這並不會導致程式碼中斷。您可以繼續使用現有的用戶端程式庫。
子版本包含不會影響現有程式碼的新功能或更新內容。如要使用這些新功能,請將用戶端程式庫升級至最新版本。
日落
我們會定期停用舊版 Google Ads API。當版本即將停用時,我們會在開發人員網誌上張貼通知。淘汰時間表已更新為日後的停用日期。