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 群組中張貼通知。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-10 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-10 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-10 (世界標準時間)。"]]