版本管理

語意版本管理

Google Ads API 會遵循語意化版本管理 一個主要版本和一個子版本版本格式為 MAJOR.MINORvMAJOR_MINOR。舉例來說,v17_0 是主要版本,而 v17_1 是子版本。

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

主要版本

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

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

https://googleads.googleapis.com/vX

如果您是從較舊的主要版本升級,程式碼可能需要 一旦切換至新的主要版本端點,就會發生變動。如果您使用我們的 用戶端程式庫,然後升級至最新版本。 有主要版本發布時,我們會提供遷移指南, 修正程式碼的所有破壞性變更

破壞性變更的例子包括:

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

子版本

子版本只會推出回溯相容的變更。針對子版本 「vMAJOR_MINOR」的「MINOR」數字大於零。

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

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

日落

我們會定期停用舊版 Google Ads API。我們會在 Android Vitals 中 開發人員網誌上。 即將停用的版本 淘汰時間表已更新為日後的停用時程 日期。