本頁面記錄了 Google Analytics (分析) Configuration API 的所有變更。其中包含 Provisioning API 和 Management API 的變更記錄。我們建議 API 開發人員定期查看這份清單,瞭解是否有任何新公告。您也可以透過下方「訂閱」部分下方的動態消息訂閱變更。
訂閱相關變更記錄
包含所有集合、設定和 Reporting API。
包含 Management API 和 Provisioning API。
Management API - 2018-07-17 版 (2018 年 7 月 17 日)
hashClientId 方法新增至 Management API
hashClientId 方法會為指定用戶端 ID 提供雜湊。您可以透過某些匯出的資料格式 (例如匯出至 BigQuery 的 Google Analytics (分析) 資料) 找到這組 ID。
Management API - 2018 年 5 月 11 日版本 (2018 年 5 月 11 日)
Management API 中的使用者資料保留設定
您現在可以使用新增至 WebProperty 資源的新「data 保留 Ttl」和「data 保留 ResetOnNewActivity」欄位,透過程式輔助方式設定使用者資料保留設定。
User Deletion API - 2018 年 5 月版本 (2018 年 5 月 10 日)
這是 User Deletion API 的初始版本:
- User Deletion API 可讓 Google Analytics (分析) 客戶從專案或網站資源中刪除特定使用者的資料。使用者刪除要求可使用 Firebase 專案或 Google Analytics (分析) 資源提出。詳情請參閱 User Deletion API 總覽。
Management API - 2018 年 2 月 22 日版本 (2018 年 2 月 22 日)
在 Management API 中寫入作業
在 Web 資源、資料檢視 (設定檔) 和目標資源中寫入 Management API (例如建立、更新、刪除、修補程式) 時,不再需要列入許可清單。Management API 中所有寫入作業的預設每日限制為每天 50 次寫入作業。詳情請參閱限制與配額頁面。
Management API - 2017 年 4 月 19 日版本 (2017 年 4 月 19 日)
再行銷目標對象 - 最佳化支援
這個版本支援 Google 最佳化工具「OPTIMIZE
」連結的廣告帳戶類型。詳情請參閱再行銷目標對象參考文件和再行銷目標對象開發人員指南。
Management API - 2017 年 3 月 23 日版本 (2017 年 3 月 23 日)
再行銷目標對象
這個版本會將 DELETE
動詞新增至「再行銷目標對象」資源。詳情請參閱再行銷目標對象開發人員指南。
- 再行銷目標對象:刪除 - 刪除再行銷目標對象。
Management API - 2017 年 2 月 9 日版本 (2017 年 2 月 9 日)
自訂指標
這是錯誤修正版本,修正了在未設定 min_value
的情況下,建立 TIME
類型的自訂指標失敗的問題。不含 min_value
的要求現在會建立自訂指標,並將預設 min_value
設為 0。
Management API - 2016 年 8 月 9 日版本 (2016 年 8 月 9 日)
貨幣
這是錯誤修正版本,修正了 Analytics (分析) 網頁介面支援部分貨幣但 API 不支援貨幣的問題。這個版本支援以下貨幣:
- 阿拉伯聯合大公國、阿拉伯聯合大公國、巴林、智利、哥倫比亞、埃及、克羅埃西亞、以色列、馬其頓、馬來西亞令吉、巴基斯坦、巴基斯坦、RON、RSD、SAR、SGD、VEF、LVL
詳情請參閱:資料檢視 (設定檔) 參考資料。- 貨幣參考資料說明中心文章。
Management API - 2016 年 8 月 8 日版本 (2016 年 8 月 8 日)
這個版本會在 Management API 中加入再行銷目標對象。
再行銷家庭
透過 Management API,您可以針對 Google Analytics (分析) 資源create
、get
、list
、update
和 patch
再行銷目標對象。如要進一步瞭解再行銷目標對象的運作方式,請參閱說明中心的「關於 Analytics (分析) 中的再行銷目標對象」一文。
Management API - 2016 年 3 月 11 日版本 (2016 年 3 月 11 日)
主演
這個版本會將 starred
資源新增至「帳戶摘要」、「帳戶」、「網站資源」和「資料檢視 (設定檔)」。
Management API - 2016 年 2 月 25 日版本 (2016 年 2 月 25 日)
錯誤頻率限制
一直以來,我們的政策規定開發人員在處理 500 或 503 回應時,應執行指數輪詢。為強制執行這項政策,我們今天將推出錯誤頻率限制為 500 和 503 錯誤。
- 每小時 50 次寫入要求失敗。
Management API - 2016 年 2 月 1 日版本 (2016 年 2 月 1 日)
未取樣報表
未取樣報表 API 不再有每日 100 份報表的限制。API 使用的每日每個資源權杖系統,與透過網頁介面建立未取樣報表時使用相同的權杖系統。
Management API - 2016 年 1 月 26 日版本 (2016 年 1 月 26 日)
未取樣報表
目前使用者無法存取未取樣報表,系統不會再於 Management API 回應訊息中提供下載連結。這項行為現在與使用者介面資訊主頁功能一致,只有報表擁有者才能查看所產生文件的下載連結。
Management API - 2015 年 12 月 17 日版本 (2015 年 12 月 17 日)
資料檢視 (設定檔)
這個版本會將 botFilteringEnabled
屬性新增至檢視畫面 (設定檔) 資源。這項屬性會指出資料檢視 (設定檔) 是否已啟用機器人篩選功能。詳情請參閱檢視 (個人資料) 參考說明文件。
未取樣報表
這個版本會在未取樣報表中加入 delete
方法。詳情請參閱未取樣報表刪除參考文件。
Management API - 2015 年 11 月 17 日版本 (2015 年 11 月 17 日)
路段
本版本的目的在於修正錯誤。這個版本修正了在呼叫區隔清單方法時,定義中帶有貨幣值的區隔無法正確顯示的問題。
Management API - 2015 年 10 月 6 日版本 (2015 年 10 月 6 日)
路段
本版本的目的在於修正錯誤。這個版本修正了在呼叫區隔清單方法時,如果私人區隔固定在多個資料檢視 (設定檔) 的使用者,收到 500
錯誤回應的問題。
Provisioning API - 2015-09 版 (2015 年 9 月 10 日)
這個版本會在 Provisioning API TOS URL 中加入額外參數:
- 加入
provisioningSignup=false
網址參數後,將能修正為沒有 Google Analytics (分析) 帳戶的使用者佈建 Google Analytics (分析) 帳戶時發生的問題。開發人員應更新程式碼,將這個參數加入 TOS 網址。
Management API - 2015 年 9 月 3 日版本 (2015 年 9 月 3 日)
批次處理
除了一般的批次支援功能外,這個版本也新增了 User Permissions API 的特別支援。使用者權限批次要求會大幅提升效能,並減少配額用量。
Management API - 2015 年 8 月 6 日版本 (2015 年 8 月 6 日)
資料檢視 (設定檔)
這個版本推出後,如果 insert 作業期間沒有設定檢視畫面 (設定檔) currency
,該屬性現在預設為 USD。此外,get
和 list
作業會針對先前在不含 currency
資源的情況下建立的資料檢視 (設定檔),傳回 USD。
-
請參閱《檢視 (設定檔) 開發人員指南》,進一步瞭解如何在 Management API 中使用資料檢視 (設定檔)。
-
如需資料檢視 (設定檔) 資源參數的完整清單,請參閱資料檢視 (個人資料) 參考資料。
Management API - 2015 年 5 月 28 日版本 (2015 年 5 月 28 日)
篩選器
這個版本會標示最終移除已淘汰的篩選器欄位 IS_MOBILE
和 IS_TABLET
,並應替換為 DEVICE_CATEGORY=mobile
和 DEVICE_CATEGORY=tablet
。插入、更新和修補要求,將篩選器欄位設為使用 IS_MOBILE
,IS_TABLET
會傳回錯誤。
Management API - 2015 年 5 月 5 日版本 (2015 年 5 月 5 日)
篩選器
這個版本支援在篩選器欄位使用自訂維度,方法是在所有篩選器詳細資料部分加入 fieldIndex
屬性。舉例來說,您現在可以使用 "field": "CUSTOM_DIMENSION"
和 "fieldIndex": "1"
設定篩選器運算式,讓篩選器在第一個自訂維度中運作。
目標
這個版本也修正了使用 "comparisonValue": "0"
建立目標時會失敗的問題。
Management API - 2015 年 3 月 13 日版本 (2015 年 3 月 13 日)
此版本將標記最後一次關閉並移除 dailyUpload
資源。「dailyUpload
」資源已於 2014 年 6 月 20 日正式淘汰,所有費用資料現在都應使用上傳資源完成。
- 如要進一步瞭解 Google Analytics (分析) API 淘汰程序,請參閱資料淘汰政策。
- 如要進一步瞭解如何將資料匯入 Google Analytics (分析),請參閱資料匯入開發人員指南。
Management API - 2015 年 1 月 23 日版本 (2015 年 1 月 23 日)
這個版本在 Management API、自訂維度和自訂指標中加入了兩個新的集合。
自訂維度和指標
您現在可以使用 Management API 建立、列出、取得、修補及更新自訂維度和指標。
Management API - 2015 年 1 月 8 日版本 (2015 年 1 月 8 日)
如果集合不含任何資源,所有集合的 list
方法回應現在會包含 items
屬性空白清單。先前回應中會省略 items
屬性。如需 Google Analytics (分析) 設定資料查詢和回應的完整詳情,請參閱 API 參考資料。
Management API - 2014 年 12 月 16 日版本 (2014 年 12 月 16 日)
修正錯誤
Management API - 2014 年 11 月 20 日版本 (2014 年 11 月 20 日)
這個版本推出新的 Google Analytics Management API 範圍。- analytics.manage.users.readonly
- 查看 Google Analytics (分析) 使用者權限。
Management API - 2014 年 11 月 5 日版本 (2014 年 11 月 5 日)
新增了 DEVICE_CATEGORY
篩選器欄位,IS_MOBILE
和 IS_TABLET
現已淘汰。使用 DEVICE_CATEGORY=mobile
和 DEVICE_CATEGORY=tablet
。
Management API - 2014 年 10 月 29 日版本 (2014 年 10 月 29 日)
資料檢視 (設定檔) 資源現在包含 enhancedECommerceTracking
資源,指出加強型電子商務已啟用 (true
) 或停用 (false
)。
Management API - 2014-06 版 (2014 年 6 月 20 日)
此版本包含新的資料匯入類型,並已淘汰 dailyUpload
資源。
資料匯入
如要進一步瞭解如何使用 Management API 將資料匯入 Google Analytics (分析) 帳戶,請參閱資料匯入開發人員指南。
上傳內容
upload
資源現在支援下列上傳類型:- 廣告活動資料
- 內容資料
- 費用資料
- 產品資料
- 退款資料
- 使用者資料
upload
資源有一個新的migrateDataImport
方法,可用來遷移現有的費用資料customDataSources
。
每日上傳功能淘汰
Provisioning API - 2014 年 5 月 5 日 (2014 年 5 月 28 日)
這是 Provisioning API 的初始版本:
- Provisioning API 能透過程式輔助方式建立新的 Google Analytics (分析) 帳戶。這個 API 僅供受邀的服務供應商和大型合作夥伴使用。詳情請參閱 Provisioning API 總覽。
Management API - 2014 年 5 月版本 (2014 年 5 月 28 日)
這個版本會新增兩個新的設定 API。
AdWords 連結
-
您可以透過 Management API 中的 AdWords 連結,建立、列出、取得、更新、修補及刪除 Google AdWords 帳戶與 Google Analytics (分析) 資源之間的連結,以及管理連結至 AdWords 資料的資料檢視 (設定檔)。
篩選器
-
您可以運用 Management API 中的篩選器,為 Google Analytics (分析) 帳戶建立、列出、取得、更新、修補及刪除篩選器。設定檔篩選器連結可讓您建立、列出、取得、更新、修補及刪除篩選器和資料檢視 (設定檔) 之間的連結。
Management API - 2014 年 5 月 27 日版本 (2014 年 5 月 27 日)
未取樣報表:Management API
Management API 即將加入一項新資源,名稱為未取樣報表。未取樣報表指的是 Google Analytics (分析) 報表,使用未取樣資料產生。「未取樣報表」目前只提供給 Google Analytics Premium 使用者使用。
- 請參閱開發人員指南
Management API - 2014 年 4 月 11 日版本 (2014 年 4 月 11 日)
區隔:Management API v2.4 和 3.0
我們已對區隔集合進行下列變更:
- API 現已支援使用者和序列區隔。
- 區隔集合現在會傳回所有內建和自訂的工作階段層級和使用者層級區隔。
- 區隔的
definition
屬性現在會使用新的區隔語法。這包括現有工作階段層級區隔的定義,會從definition: "
變更為" definition: "sessions::condition::
。" - 區隔資源已新增
type
資源,用來標明區隔是CUSTOM
(也就是由網頁介面中的使用者建立) 或BUILT_IN
(由 Google Analytics (分析) 提供)。
實驗
下列 AdSense 指標已可當做最佳化目標:
ga:adsenseAdsClicks
:您網站上 AdSense 廣告的點擊次數。ga:adsenseAdsViewed
:AdSense 廣告瀏覽次數。一個廣告單元可以顯示多則廣告。ga:adsenseRevenue
:AdSense 廣告帶來的總收益。
Management API - 2014 年 3 月 25 日版本 (2014 年 3 月 25 日)
新帳戶摘要集合
- AccountSummaries 集合已新增至 Management API。這項工具會在單次快速要求中,列出授權使用者可存取的每個帳戶、資源和資料檢視 (設定檔) 的資訊摘要。詳情請參閱《帳戶摘要開發人員指南》。
Management API - 2013 年 12 月 12 日版本 (2013 年 12 月 12 日)
由於 ga:isMobile
和 ga:isTablet
維度淘汰,我們已對預設區隔進行下列變更:
- 區隔
gaid::-11
已從「行動裝置流量」重新命名為「行動裝置和平板電腦流量」。這個區隔的定義已從「ga:isMobile==Yes
」變更為「ga:deviceCategory==mobile,ga:deviceCategory==tablet
」。請注意,ga:isMobile
包含平板電腦流量,這項數據會反映在新定義中。如果您只想排除行動流量,但要排除平板電腦,請切換到新的「行動裝置流量」區隔 (gaid::-14
)。 - 區隔「
gaid::-13
」定義已從「ga:isTablet==Yes
」變更為「ga:deviceCategory==tablet
」。這仍代表平板電腦流量。 - 已新增區隔「
gaid::-14
」。區隔名稱為「行動裝置流量」,定義則是ga:deviceCategory==mobile
。
Management API - 2013 年 10 月 28 日版本 (2013 年 10 月 28 日)
修正錯誤:
- 檢視 (設定檔) 的時區資訊已修正。詳細資料:在此修正前,某些情況下,在 Management API 列出資料檢視 (設定檔) 時,系統傳回不正確的資料檢視 (設定檔) 時區資訊。現在資料檢視 (設定檔) 的時區資訊與 Google Analytics (分析) 管理員介面中的設定一致。
Management API - 2013 年 10 月 4 日版本 (2013 年 10 月 4 日)
上傳項目 (擴增維度)
- 新的上傳資源可讓您上傳「擴增維度」資料。詳情請參閱《資料匯入 (上傳) 開發人員指南》。
Management API - 2013 年 10 月 3 日版本 (2013 年 10 月 3 日)
這個版本推出了網站資源、資料檢視 (設定檔) 和目標資源的寫入作業,以及一組啟用使用者權限管理功能的新資源組合。
帳戶設定和 Configuration API
- 您現在可以建立、更新、修補和刪除資料檢視 (設定檔)。如要進一步瞭解新方法,請參閱資料檢視 (設定檔) 參考資料。
- 您現在可以建立、更新和修補網站資源和目標。如要進一步瞭解這些新方法,請參閱網站資源參考資料和目標參考資料。
- 使用
get
方法,即可請求單一網站資源、資料檢視 (設定檔) 或目標。 - 這些功能目前為開發人員預覽版,仍在測試階段。如果你有意申請使用,請申請加入 Beta 版計畫。
Management API 中的使用者權限
- 新的 accountUserLinks 資源可讓您管理使用者的帳戶權限。
- 新的 webpropertyUserLinks 資源可讓您管理使用者的資源權限。
- 新的 profileUserLinks 資源可讓您管理使用者的資料檢視 (設定檔) 權限。
- 授權使用者的權限現已納入帳戶、網站資源和資料檢視 (設定檔) 資源中。
- 我們已導入新的範圍,以便管理使用者權限。
https://www.googleapis.com/auth/analytics.manage.users
. - 詳情請參閱《使用者權限開發指南》。
Management API - 2013 年 7 月 15 日版本 (2013 年 7 月 16 日)
- 所有區隔 ID 都將從正整數變更為英數字元字串。如果您儲存了使用者的區隔 ID,建議您更新這些 ID 以使用新 ID。
- 區隔集合只會傳回現有的造訪層級區隔。API 目前不支援新的訪客、同類群組和序列區隔。
- 區隔集合會繼續傳回具有相同負數值編號的現有預設區隔,但目前不支援新的預設區隔。
Management API - 2013 年 6 月 5 日版本 (2013 年 6 月 5 日)
這個版本會在網站資源資源中加入 2 項新資源:
profileCount
- 傳回屬性的設定檔數量。這可讓您篩選沒有任何設定檔的資源 (例如 profileCount = 0)。industryVertical
- 傳回為資源選取的產業/類別。
修正錯誤:
- 設定檔資源的
eCommerceTracking
屬性現在與網頁介面「管理」部分中的電子商務設定一致。如果啟用電子商務追蹤,會傳回true
,否則傳回false
。
Management API - 2013 年 5 月 8 日版本 (2013 年 5 月 8 日)
- 網站資源現在包含
level
資源,可用於指出網站資源是PREMIUM
還是STANDARD
。
Management API - 2013 年 4 月 4 日版本 (2013 年 4 月 4 日)
- Management API v3 已新增端點,以便存取及修改實驗資源。
Management API - 2013 年 1 月 14 日版本 (2013 年 1 月 14 日)
- 設定檔資源現在包含
type
屬性,可用於識別是否已為網站或應用程式設定設定檔。可能的值有兩個:WEB
或APP
。
Management API - 2012-01 版 (2012 年 1 月 26 日)
這個版本加入了實用的 Management API 回應,
Management API - 2011-12 版 (2011 年 12 月 5 日)
這個版本新增資料、修改現有功能及修正錯誤。
新資料
- 「進階區隔」集合現在包含
segmentId
欄位,可用於資料匯出 API 區隔參數。
異動
-
max-results
的資料類型已變更為「integer
」。 -
max-results
的預設值和最大值已變更為 1000。
修正錯誤
- 「Google 網站最佳化工具」實驗的帳戶、網站資源和設定檔將不再納入對應的集合中。
Management API - 2011-08 年版本 (2011 年 8 月 29 日)
此版本新增兩個新版 API,其中包含許多新功能,並淘汰了舊版。這些變更會影響您從 API 要求和處理資料的方式。
3.0 版
-
這是 API 的最新主要版本,與舊版不相容。未來所有的 API 開發作業都將在這個版本中完成。
-
新資料
- 完整呈現事件目標
- 內部網站資源 ID,可用於深層連結至 Google Analytics (分析) 使用者介面
- 預設網頁和網站搜尋查詢參數的設定檔設定
-
異動
- 新增配額政策
- 與 Google API 控制台整合,以管理 API 存取權並要求提高配額
- 支援 OAuth 2.0 做為授權的新建議方式
- 提出要求的新網址:
https://www.googleapis.com/analytics/v3/management/…
- 使用 JSON 執行更精簡的 API 回應
- 新的 Google API 用戶端程式庫,支援更多語言
- 支援 Google Discovery API
2.4 版
-
這是次要版本升級,主要回溯相容於現有 2.3 版。
-
異動
- 新增配額政策
- 與 Google API 控制台整合,以管理 API 存取權並要求提高配額
- 持續支援現有的授權機制和 OAuth 2.0
- 提出要求的新網址:
https://www.googleapis.com/analytics/v2.4/management/…
- 僅限 XML 格式回覆
- 不支援 Google Data JavaScript 用戶端程式庫
- XML 輸出與 2.3 版一致,因此其他現有的 Google Data 用戶端程式庫會繼續運作。
淘汰
- 我們宣布即將淘汰 2.3 版 Management API。會繼續運作兩個月,之後所有 v2.3 要求都會傳回 v2.4 回應。
Management API - 2010-08 年版本 (2010 年 8 月 18 日)
這是 Google Analytics (分析) Management API 的 Beta 版!
新動態饋給
更新後的用戶端程式庫
- Management API 即將發布至 Google Analytics (分析) 資料匯出 API 所在的程式庫中。Google Data Java 和 JavaScript 程式庫皆已更新。您可以為程式庫
getManagementFeed()
方法指定適當的動態饋給 URI,藉此存取每個動態饋給。
新增說明文件
- 我們推出了 Google Analytics (分析) 開發人員文件專區,說明新 Management API 的運作方式。