版本管理

語意化版本

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

如要查看過往版本，請參閱「版本資訊」。

主要版本

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

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

https://googleads.googleapis.com/vX

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

這類變更包括：

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

子版本

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

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

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

日落

舊版 Google Ads API 會定期淘汰。如果某個版本即將停用，我們會透過開發人員網誌發布公告。淘汰時間表會更新未來的淘汰日期。