Search Ads 360 Reporting API 使用語意版本管理。
有主要版本和子版本,格式為 vMAJOR_MINOR
。舉例來說,v0_0
是第一個主要版本,v0_1
則是第一個子版本。版本號碼的後置字串代表版本類型:主要版本一律會為零,而針對子版本則一律大於零。
主要版本
重大版本導入了破壞性變更,即不具回溯相容性的變更。
每個主要版本都有各自的端點,例如:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
從某個主要版本升級至另一個版本時,您可能需要先修改程式碼,才能切換到新的主要版本端點。
如果您使用用戶端程式庫,請升級至最新版本。新的主要版本提供了遷移指南,可協助您修正程式碼中的所有破壞性變更。
破壞性變更的例子包括:
- 移除或重新命名服務、介面、欄位、方法或列舉值。
- 變更欄位類型。
- 變更資源名稱格式。
- 變更 HTTP 定義中的網址格式。
- 變更輸出格式,例如將
0
變更為--
做為預設值。 - 將傳回的錯誤原因從 A 改為 B。
子版本
子版本只會推出回溯相容的變更。
子版本發布時,已使用的端點會自動更新。這不會導致程式碼中斷。您可以繼續使用現有的用戶端程式庫。
子版本包含不會影響現有程式碼的新功能或更新。如要使用這項新功能,您必須將用戶端程式庫升級至最新版本。
日落
我們即將停用舊版 Search Ads 360 Reporting API 版本時,我們會在 searchads-api-announcements Google 群組中發布通知。