Google Analytics (分析) - 所有設定 API 變更記錄

本頁面說明 Google Analytics (分析) Configuration API 的所有變更。其中包括 Provisioning API 和 Management API 的變更記錄。我們建議 API 開發人員定期查看這份清單，掌握任何新公告。您也可以透過下方訂閱區段下方的資訊提供訂閱變更。

訂閱相關變更記錄

所有 Google Analytics (分析) API 變更記錄
–
訂閱 rss

包含所有 Collection、Configuration 和 Reporting API。

所有 Configuration API 變更記錄
–
訂閱 rss

包含 Management API 和 Provisioning API。

Management API 中的使用者資料保留設定

您現在可以透過程式化的方式，使用WebProperty 資源內新增的「datakeepTtl」和「datareservationResetOnNewActivity」欄位，以程式輔助方式調整使用者資料保留設定。

這是 User Deletion API 的初始版本：

  • User Deletion API 可讓 Google Analytics (分析) 客戶從專案或網站資源中刪除特定使用者的資料。您可以透過 Firebase 專案或 Google Analytics (分析) 資源提出使用者刪除要求。詳情請參閱「User Deletion API 總覽」一文。

Management API 中的寫入作業

針對網站資源、資料檢視 (設定檔) 和目標資源，使用 Management API 的寫入作業 (例如建立、更新、刪除、修補) 不再需要加入許可清單。Management API 中所有寫入作業的預設每日限制為每天 50 次寫入作業。詳情請參閱「限制與配額」頁面。

自訂指標

這個版本修正了錯誤，修正在未設定 min_value 的情況下，建立 TIME 類型的自訂指標會失敗。不含 min_value 的要求現在會建立自訂指標，並將 min_value 預設為 0。

未取樣報表

未取樣報表 API 不再有每日 100 份報表的限制。API 會使用與透過網頁介面建立未取樣報表時一樣，使用「每個資源每日」的權杖系統。

未取樣報表

目前使用者無法存取的未取樣報表，管理 API 回應訊息中不會再出現下載連結。這項行為與 UI 資訊主頁功能一致，因此只有報表擁有者可以查看所產生文件的下載連結。

資料檢視 (設定檔)

這個版本會將 botFilteringEnabled 屬性新增至資料檢視 (設定檔) 資源。這個屬性指出是否已啟用資料檢視 (設定檔) 的漫遊器篩選功能。詳情請參閱查看 (設定檔) 參考資料文件。

未取樣報表

這個版本會將 delete 方法加入未取樣報表。詳情請參閱未取樣報表刪除參考文件。

路段

本版本用意為修正錯誤。這個版本修正了在呼叫區隔清單方法時，定義中含貨幣值的區隔無法正確顯示的問題。

路段

本版本用意為修正錯誤。這個版本修正了一項問題，會導致將私人區隔固定在多個資料檢視 (設定檔) 的使用者呼叫區隔清單方法時收到 500 錯誤回應。

這個版本會在 Provisioning API TOS 網址新增一個參數：

  • 新增網址參數 provisioningSignup=false，修正了為沒有 Google Analytics (分析) 帳戶的使用者佈建 Google Analytics (分析) 帳戶時會發生的問題。開發人員應更新程式碼，將這個參數加入服務條款網址。

批次處理

在這個版本中，除了一般的批次支援外，我們也為 User Permissions API 新增了特別支援。批次使用者權限要求會大幅提升效能，並降低配額用量。

資料檢視 (設定檔)

這個版本推出後，如果在 insert 作業期間未設定資料檢視 (設定檔) currency 資源，現在會預設為 USD。此外，get 和 list 作業也會針對先前在沒有 currency 資源的情況下建立的資料檢視 (設定檔)，傳回 USD。

濾鏡

這個版本將移除淘汰的篩選器欄位 IS_MOBILE 和 IS_TABLET，應替換為 DEVICE_CATEGORY=mobile 和 DEVICE_CATEGORY=tablet。插入、更新及修補要求 (將篩選器欄位設為使用 IS_MOBILE 和 IS_TABLET) 將傳回錯誤。

濾鏡

這個版本支援在所有篩選器詳細資料部分中加入 fieldIndex 屬性，以便將自訂維度用於篩選器欄位。舉例來說，現在可以使用 "field": "CUSTOM_DIMENSION" 和 "fieldIndex": "1" 設定篩選器運算式，讓篩選器在第一個自訂維度上運作。

目標

此版本也修正了使用 "comparisonValue": "0" 建立目標時會失敗的問題。

這個版本將標示最終終止，並移除 dailyUpload 資源。dailyUpload 資源已於 2014 年 6 月 20 日正式淘汰，現在所有費用資料都應使用上傳資源完成。

如果集合不包含任何資源，則所有集合的 list 方法回應現在會包含 items 屬性的空白清單。過去，回應會省略 items 屬性。請參閱 API 參考資料，瞭解 Google Analytics (分析) 設定資料查詢與回應的完整詳情。

這個版本推出 Google Analytics Management API 的新範圍。- analytics.manage.users.readonly - 查看 Google Analytics (分析) 使用者權限。

新增了 DEVICE_CATEGORY 篩選器欄位，IS_MOBILE 和 IS_TABLET 現已淘汰。使用 DEVICE_CATEGORY=mobile 和 DEVICE_CATEGORY=tablet。

資料檢視 (設定檔) 資源現在包含enhancedECommerceTracking資源，指出「加強型電子商務」是啟用 (true) 還是停用 (false)。

這個版本包含新的資料匯入類型和淘汰 dailyUpload 資源。

資料匯入

若要進一步瞭解如何使用 Management API 將資料匯入 Google Analytics (分析) 帳戶，請參閱資料匯入開發人員指南。

上傳內容

  • upload 資源現在支援下列上傳類型：
    • 廣告活動資料
    • 內容資料
    • 費用資料
    • 產品資料
    • 退款資料
    • 使用者資料
  • upload 資源採用新的 migrateDataImport 方法，可遷移現有的費用資料 customDataSources。

每日上傳淘汰項目

  • dailyUpload 資源現已淘汰！如要進一步瞭解如何改用「資料匯入」功能，請參閱遷移指南。
  • dailyUpload 資源會繼續運作六個月，之後任何 uploadType 屬性設為 analytics#dailyUploads 的 customDataSources 都會自動遷移，並且僅適用於 upload 資源。
  • dailyUpload 資源的現有使用者應盡快更新程式碼並遷移至上傳資源。

這是 Provisioning API 的初始版本：

  • Provisioning API 可讓您透過程式輔助方式建立新的 Google Analytics (分析) 帳戶。這個 API 僅限受邀者使用，適用於合格的服務供應商和大型合作夥伴。詳情請參閱「Provisioning API 總覽」。

這個版本新增兩個新的設定 API。

濾鏡

未取樣報表： Management API

我們即將在 Management API 中新增一項名為「未取樣報表」的資源。未取樣報表是指透過未取樣資料產生的 Google Analytics (分析) (GA) 報表。「未取樣報表」目前僅供 Google Analytics Premium 使用者使用。

區隔： Management API 2.4 版和 3.0 版

我們對區隔集合進行了以下變更：

  • API 現已支援使用者和序列區隔。
  • 「區隔集合」現在會傳回所有內建和自訂的工作階段層級以及使用者層級區隔。
  • 區隔的 definition 屬性將使用新的區隔語法。這包括現有工作階段層級區隔的定義，該區隔將從 definition: "" 變更為 definition: "sessions::condition::"。
  • 在 Segment 資源中加入新的 type 資源，以指出區隔是 CUSTOM (也就是使用者在網頁介面中建立) 還是 BUILT_IN (由 Google Analytics (分析) 提供)。

實驗

您現在可以使用下列 AdSense 指標做為最佳化目標：

  • ga:adsenseAdsClicks：您網站上的 AdSense 廣告點擊次數。
  • ga:adsenseAdsViewed：AdSense 廣告獲得的觀看次數。一個廣告單元中可以顯示多個廣告。
  • ga:adsenseRevenue：AdSense 廣告的總收益。

新帳戶摘要收集

  • Management API 已新增 AccountSummaries 集合。透過一個快速要求，獲得授權的使用者可存取各個帳戶、資源和資料檢視 (設定檔) 的資訊摘要。詳情請參閱《帳戶摘要開發人員指南》。

基於 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」。區隔的名稱為「Mobile Traffic」，定義則為 ga:deviceCategory==mobile。

修正錯誤：

  • 已修正資料檢視 (設定檔) 的時區資訊。詳細資訊：在修正這個問題之前，在某些情況下，系統在 Management API 中列出資料檢視 (設定檔) 時，系統會傳回不正確的時區資訊 (設定檔)。資料檢視 (設定檔) 的時區資訊會與 Google Analytics (分析) 管理員介面中設定的時區資訊一致。

這個版本推出適用於網站資源、資料檢視 (設定檔) 和目標資源的寫入作業，以及一組 3 項啟用使用者權限管理功能的新資源。

帳戶設定和設定 API

  • 您現在可以建立、更新、修補及刪除資料檢視 (設定檔)。如要進一步瞭解這些新方法，請參閱資料檢視 (設定檔) 參考資料。
  • 現在，您可以建立、更新及修補網站資源和目標。如要進一步瞭解這些新方法，請參閱網站資源參考資料和目標參考資料。
  • 現在可以使用 get 方法請求單一網站資源、資料檢視 (設定檔) 或目標。
  • 這些功能目前是開發人員預覽版的 Beta 版，如果您有意申請使用，請申請試用 Beta 版。

Management API 中的使用者權限

隨著新區隔推出，我們將針對區隔集合推出下列變更：

  • 所有區隔 ID 都會從正整數變更為英數字元字串。如果您已儲存使用者的區隔 ID，建議您將其更新為使用新的 ID。
  • 「區隔集合」只會傳回現有的造訪層級區隔。API 目前不支援新訪客、同類群組和序列區隔。
  • 「區隔集合」將繼續傳回具有相同負數 ID 的現有預設區隔，但系統目前不支援新的預設區隔。

這個版本在網站資源資源中加入 2 項新資源：

  • profileCount - 傳回資源的設定檔數量。這可讓您篩選沒有任何設定檔 (即 profileCount = 0) 的資源。
  • industryVertical - 傳回為資源選取的產業產業/類別。

修正錯誤：

  • 設定檔資源的 eCommerceTracking 資源現在與網頁介面「管理」區段中的「電子商務」設定一致。啟用電子商務追蹤功能時，會傳回 true，否則會傳回 false。
  • 網站資源現在包含 level 資源，用於指出網站資源是 PREMIUM 還是 STANDARD。
  • Management API v3 新增了端點，以便存取及修改 Experiments 資源。
  • 設定檔資源現在包含 type 屬性，可識別是否為網站或應用程式設定的設定檔。可能的值包括：WEB 或 APP。

這個版本為 Management API 新增實用的錯誤回應。

  • API 錯誤回應內文已新增錯誤代碼、原因和說明。所有程式碼都已記錄在 Management API 2.4 版和版本 3.0 等版本中。

此版本新增資料、變更現有功能並修正錯誤。

新資料

  • 進階區隔集合現在包含 segmentId 欄位，可用於資料匯出 API 區隔參數。

異動

  • 「max-results」的資料類型已變更為「integer」。

  • max-results 的預設值和最大值已變更為 1000。

修正錯誤

  • 「Google 網站最佳化工具」實驗的帳戶、網站資源和設定檔不再包含在相應的集合中。

這個版本新增兩個包含許多新功能的新版 API，但已淘汰舊版本。這些變更會影響您向 API 要求和處理資料的方式。

3.0 版

  • 這是最新的 API 主要版本，無法回溯相容。日後所有開發 API 都將透過這個版本完成。

  • 新資料

    • 事件目標的完整呈現
    • 內部網站資源 ID，可用來深層連結到 Google Analytics (分析) 使用者介面
    • 預設網頁和網站搜尋查詢參數的設定檔設定

  • 異動

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 資料用戶端程式庫將繼續運作。

淘汰

  • 我們宣布淘汰 Management API 舊版 2.3 版。該指令碼會繼續運作兩個月，之後所有 v2.3 要求都會傳回 v2.4 回應。

這是 Google Analytics Management API 的 Beta 版！

新動態饋給

已更新的用戶端程式庫

  • Management API 發布在與 Google Analytics (分析) 資料匯出 API 相同的程式庫中。Google Data Java 和 JavaScript 程式庫都已更新。如要存取每個動態饋給，請為 getManagementFeed() 方法指定適當的動態饋給 URI。

新增說明文件

  • 我們新增了 Google Analytics (分析) 開發人員文件章節，說明新版 Management API 的運作方式。