語意版本管理
Google Ads API 採用語意化版本管理,其中包含主要版本和次要版本。這個版本的格式為 MAJOR.MINOR
或 vMAJOR_MINOR
。舉例來說,v11_0
是主要版本,v11_1
是次要版本。
請參閱版本資訊瞭解舊版。
主要版本
主要的發布版本導入了一些與前期不相容的變更。
這個版本的結尾會是零,格式為 vX_0
,其中 X
是主要版本號碼。
每個主要版本都有各自的端點。以網址為例,其中 X
是主要版本號碼。
https://googleads.googleapis.com/vX
如果您是從較舊的主要版本進行升級,則在切換至新的主要版本端點時,您的程式碼可能需要變更。如果您使用的是我們的用戶端程式庫,請升級至最新版本。有重大版本發布時,我們會提供遷移指南,協助您修正程式碼中的任何破壞性變更。
破壞性變更的範例包括:
- 移除或重新命名服務、介面、欄位、方法或列舉值。
- 變更欄位類型。
- 變更資源名稱格式。
- 變更 HTTP 定義中的網址格式。
- 變更輸出格式,例如將預設值從
0
變更為--
。 - 將錯誤原因從 A 改成 B。
次要版本
次要版本僅導入與回溯相容的變更。如果是次要版本,vMAJOR_MINOR
的 MINOR
數字必須大於零。
當次要版本發布時,使用中的端點會自動更新。但這不會導致程式碼失效。您可以繼續使用現有的用戶端程式庫。
次要版本包含對現有程式碼造成影響的新功能或更新內容。如果您想要使用這些新功能,請將您的用戶端程式庫升級至最新版本。
日落
舊版 Google Ads API 會定期停用。當版本即將淘汰時,我們會在開發人員網誌上張貼通知。淘汰時間表會更新為未來的日落日期。