版本管理

語意版本管理

Google Ads API 遵循語意化版本管理,其中包含主要和子版本。版本格式為 MAJOR.MINORvMAJOR_MINOR,舉例來說,v17_0 是主要版本,v17_1 則是子版本。

如要查看過往版本的版本資訊

主要版本

主要發布版本有些破壞性和回溯不相容的變更。版本會以零的結尾 (格式為 vX_0),其中 X 是主要版本號碼。

每個主要版本都有單獨的端點。以下是網址範例,其中 X 是主要版本號碼。

https://googleads.googleapis.com/vX

如果您是從舊的主要版本升級,則切換至新的主要版本端點時,程式碼可能需要變更。如果您使用用戶端程式庫,請升級至最新版本。有主要版本發布時,我們會提供遷移指南,引導您修正程式碼的任何破壞性變更。

破壞性變更的例子包括:

  • 移除或重新命名服務、介面、欄位、方法或列舉值。
  • 變更欄位類型。
  • 變更資源名稱格式。
  • 變更 HTTP 定義中的網址格式。
  • 變更輸出格式,例如從 0 變更為 -- 為預設值。
  • 變更從 A 傳回的錯誤原因。

子版本

子版本只會推出回溯相容的變更。如果是子版本,vMAJOR_MINORMINOR 數字會大於零。

發布子版本時,系統會自動更新已在使用中的端點。這並不會導致程式碼中斷。您可以繼續使用現有的用戶端程式庫。

子版本包含不會影響現有程式碼的新功能或更新內容。如要使用這些新功能,請將用戶端程式庫升級至最新版本。

日落

我們會定期停用舊版 Google Ads API。當版本即將停用時,我們會在開發人員網誌上張貼通知。淘汰時間表已更新為日後的停用日期。