版本管理

語義版本管理

主要和次要版本的 Google Ads API 會遵循語意化版本管理。版本的格式為 MAJOR.MINORvMAJOR_MINOR。舉例來說,v13_0 是主要版本,v13_1 則是次要版本。

如需過往版本的相關資訊,請參閱版本資訊

主要版本

主要發布版本導入了幾項與舊版不相容的破壞性變更。 該版本將以零結尾,格式為 vX_0,其中 X 是主要版本號碼。

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

https://googleads.googleapis.com/vX

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

破壞性變更的範例包括:

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

子版本

次要版本只會導入回溯相容的變更。如果是次要版本,vMAJOR_MINORMINOR 數字必須大於零。

次要版本推出時,目前使用的端點會自動更新。但這不會導致程式碼毀損。您可以繼續使用現有的用戶端程式庫。

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

日落

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