版本管理

語意版本管理

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

如要查看過往版本,請參閱版本資訊

主要版本

主要發布版本引入了一些破壞性及回溯不相容的變更。這個版本的結尾是 0,格式為 vX_0,其中 X 是主要版本號碼。

每個主要版本都有各自的端點。此網址範例的 X 是主要版本號碼。

https://googleads.googleapis.com/vX

如果您是從較舊的主要版本升級,在切換至新的主要版本端點時,程式碼可能需要變更。如果您使用我們的用戶端程式庫,請升級至最新版本。每當有主要版本推出時,我們會提供遷移指南,協助您修正程式碼中的所有破壞性變更。

破壞性變更的例子包括:

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

子版本

子版本只會提供回溯相容的變更。若是子版本,vMAJOR_MINORMINOR 數字會大於零。

當子版本釋出時,使用中的端點會自動更新。這不會造成程式碼毀損。您可以繼續使用現有的用戶端程式庫。

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

日落

我們會定期停用舊版 Google Ads API。版本即將停用時,我們會透過開發人員網誌發布通知。淘汰時間表會配合未來的淘汰日期進行更新。