Search Ads 360 Reporting API 中的版本管理功能

Search Ads 360 Reporting API 使用語意化版本管理

分為主要版本和子版本,格式為 vMAJOR_MINOR。舉例來說,v0_0 是 第一個主要版本,v0_1 第一個子版本。開頭的 version number 會指出版本類型:如果主要版本一律為零, 如果是次要版本,則一律大於 0。

主要版本

主要版本導入了破壞性變更,也就是不會進行 回溯相容

每個主要版本都有單獨的端點,例如:

https://searchads360.googleapis.com/v0

https://searchads360.googleapis.com/v1

升級主要版本時,您可能需要 ,再切換至新的主要版本端點。

如果您使用用戶端程式庫, 您必須升級至最新版本新的主要版本可提供 遷移指南,協助您修正程式碼的任何破壞性變更。

破壞性變更的例子包括:

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

子版本

子版本只會推出回溯相容的變更。

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

子版本包含不會影響現有功能的新功能或更新內容 再也不是件繁重乏味的工作如要使用新功能,您必須升級 用戶端程式庫 版本。

日落

已排定停用舊版 Search Ads 360 Reporting API 時,我們會 在 searchads-api-announcements Google 群組中張貼通知。