語意版本管理
Google Ads API 會遵循語意化版本管理
一個主要版本和一個子版本版本格式為 MAJOR.MINOR
或
vMAJOR_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 中 開發人員網誌上。 即將停用的版本 淘汰時間表已更新為日後的停用時程 日期。