版本管理

目標： 瞭解 Google Ads API 版本管理的運作方式。

語意版本管理

Google Ads API 遵循語義版本管理，其中包含主要版本和次要版本。版本格式為 MAJOR.MINOR 或 vMAJOR_MINOR。舉例來說，v18_0 是主要版本，v18_1 則是次要版本。

如要瞭解過往版本，請參閱版本資訊。

主要版本

主要版本會推出一些破壞性且回溯不相容的變更。版本號碼結尾為零，格式為 vX_0，其中 X 是主要版本號碼。

每個主要版本都有專屬端點。以下是網址範例，其中 X 是主要版本號碼。

https://googleads.googleapis.com/vX

如果您要從舊的主要版本升級，則在切換至新的主要版本端點時，可能需要變更程式碼。如果您使用的是 用戶端程式庫，請升級至最新版本。當主要版本發布時，我們會提供遷移指南，請您仔細閱讀，以修正程式碼中的任何重大變更。

以下列舉一些重大變更：

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

子版本

次要版本只會推出回溯相容的變更。對於次要版本，vMAJOR_MINOR 的 MINOR 數字會大於零。

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

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

日落

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