如需 Google Analytics (分析) API 官方公告,請訂閱 Google Analytics API Notify Group。
2023 年 12 月 15 日:現在所有 Google Analytics (分析) 資源都提供資料存取報表。
目前所有 Google Analytics (分析) 資源 (標準版和 Google Analytics (分析) 360 客戶) 都可使用資料存取報表功能的特定欄位。
詳情請參閱結構定義說明文件。
2023 年 12 月 15 日 在資料存取報表架構中加入「accessDateHour
」維度。
在資料存取報表結構定義中新增的 accessDateHour
維度。其中包含存取 Google Analytics (分析) 報表資料的 Google Analytics (分析) 使用者日期 (小時)。
2023 年 10 月 5 日:如果資源設有「最初點擊」、「線性」、「時間衰減」和「根據排序」歸因模式,系統預設會採用跨管道以數據為準歸因模式。
自 2023 年 10 月中旬起,所有資源的最初點擊、線性、時間衰減和根據排序歸因模式,將無法與 UpdateAttributionSettings 方法搭配使用。
如果您的資源目前設定為使用其中一種模式,該模型會變更為跨管道以數據為準歸因。您還是可以選擇改用「跨管道最終點擊」或「優先計入 Google Ads 最終點擊」。
2023-09-01 新增了 SKAdNetwork 轉換價值結構定義設定方法。
已新增至 Admin API v1alpha 的 GetSKAdNetworkConversionValueSchema
、CreateSKAdNetworkConversionValueSchema
、DeleteSKAdNetworkConversionValueSchema
、UpdateSKAdNetworkConversionValueSchema
、ListSKAdNetworkConversionValueSchemas
方法。
這項功能可讓您管理 iOS 串流的 SKAdNetwork 轉換價值結構定義設定。
2023-09-01 新增了 UpdateConversionEvent
方法。
UpdateConversionEvent
方法已新增至 Admin API v1beta。
2023-09-01 BigQueryLink.enterprise_export_enabled
欄位已重新命名為 fresh_daily_export_enabled
。
BigQueryLink
資源的 enterprise_export_enabled
欄位已重新命名為 fresh_daily_export_enabled
。
2023 年 7 月 14 日 對 properties.updateAttributionSettings
和 properties.getAttributionSettings
方法進行破壞性變更。
自 2023 年 7 月 24 日起,我們將對 Admin API v1 Alpha 做出破壞性變更,這將影響 properties.getAttributionSettings 和 properties.updateAttributionSettings 方法的功能。
ReportingAttributionModel
列舉的成員將重新命名,如下所示:
舊名稱 | 新名稱 |
---|---|
CROSS_CHANNEL_DATA_DRIVEN |
PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN |
CROSS_CHANNEL_LAST_CLICK |
PAID_AND_ORGANIC_CHANNELS_LAST_CLICK |
CROSS_CHANNEL_FIRST_CLICK |
PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK |
CROSS_CHANNEL_LINEAR |
PAID_AND_ORGANIC_CHANNELS_LINEAR |
CROSS_CHANNEL_POSITION_BASED |
PAID_AND_ORGANIC_CHANNELS_POSITION_BASED |
CROSS_CHANNEL_TIME_DECAY |
PAID_AND_ORGANIC_CHANNELS_TIME_DECAY |
ADS_PREFERRED_LAST_CLICK |
GOOGLE_PAID_CHANNELS_LAST_CLICK |
AdsWebConversionDataExportScope
列舉的成員將重新命名,如下所示:
舊名稱 | 新名稱 |
---|---|
CROSS_CHANNEL |
PAID_AND_ORGANIC_CHANNELS |
ADS_PREFERRED |
GOOGLE_PAID_CHANNELS |
2023-07-10 將 ads_web_conversion_data_export_scope
欄位新增至 AttributionSettings
類型
已將 ads_web_conversion_data_export_scope
欄位新增至 AttributionSettings
類型,您可以使用 UpdateAttributionSettings
方法修改該欄位。
2023 年 6 月 5 日 淘汰「最初點擊」、「線性」、「時間衰減」和「根據排序」歸因模式。
自 2023 年 6 月起,您無法使用 UpdateAttributionSettings 方法來設定 GA4 資源的最初點擊、線性、時間衰減和根據排序歸因模式。自 2023 年 9 月起,這些模型將無法用於所有資源。
詳情請參閱 Google Analytics (分析) 產品公告。
2023 年 5 月 31 日新增 AdSense 連結管理方式。
已新增至 Admin API v1alpha 的 GetAdSenseLink
、CreateAdSenseLink
、DeleteAdSenseLink
、ListAdSenseLinks
方法。
這項功能可讓您管理 GA4 資源的 AdSense 與 Analytics (分析) 連結。
2023-05-31 新增查詢已連結 GA4 資源的方法。
已新增至 Admin API v1alpha 的 FetchConnectedGa4Property
方法
這項功能可讓您在 GA4 遷移過程中,取得已連結通用 Analytics (分析) 資源的 GA4 資源相關資訊。
2023-05-31 新增管理事件建立規則的方法。
已新增至 Admin API v1alpha 的 CreateEventCreateRule
、UpdateEventCreateRule
、DeleteEventCreateRule
、ListEventCreateRules
、GetEventCreateRule
方法。
這項功能可讓您管理事件建立規則,根據與來源事件相符的條件觸發建立全新事件。
2023 年 5 月 31 日 新增管理自訂管道群組的方法。
已將 GetChannelGroup
、ListChannelGroups
、CreateChannelGroup
、UpdateChannelGroup
、DeleteChannelGroup
方法新增至 Admin API v1alpha。
這項功能可讓您管理網站流量來源的自訂管道群組。
建立完成後,您可以使用 Google Analytics Data API v1 查詢自訂管道群組。
2023 年 3 月 31 日新增加強型評估設定管理方法。
已新增至 Admin API v1alpha 的 properties.dataStreams.updateEnhancedMeasurementSettings
、properties.dataStreams.getEnhancedMeasurementSettings
方法。
這項功能可讓您管理 GA4 資源網站資料串流的加強型評估設定。
2023-03-31 新增「已連結的網站代碼」管理方法。
已在 Admin API v1alpha 中新增的 properties.createConnectedSiteTag
、properties.deleteConnectedSiteTag
、properties.listConnectedSiteTags
方法。
這項功能可用來管理已連結的網站代碼,也有助於將流量從通用 Analytics (分析) 資源轉送至 Google Analytics (分析) 4 資源。
2023-03-31 在 Admin API v1beta 中新增帳戶和資源層級的 runAccessReport
方法。
已新增至 Admin API v1beta 版本的 properties.runAccessReport
和 accounts.runAccessReport
方法。方法會傳回自訂的資料存取記錄報表。
2023 年 2 月 24 日 新增「展開資料集」管理方法。
ExpandedDataSet
資源已新增至 API 的 v1alpha 版本,以及對應的 properties.expandedDataSets.create
、properties.expandedDataSets.delete
、properties.expandedDataSets.patch
、properties.expandedDataSets.list
、properties.expandedDataSets.get
作業。這項功能可用來管理 Google Analytics (分析) 360 中的展開資料集。
2023 年 2 月 24 日:存取權繫結將取代使用者權限管理的使用者連結。
AccessBinding
資源已新增至 API 的 v1alpha 版本,適用相關作業如下:
accounts.accessBindings.create
accounts.accessBindings.delete
accounts.accessBindings.patch
accounts.accessBindings.list
accounts.accessBindings.get
accounts.accessBindings.batchCreate
accounts.accessBindings.batchDelete
accounts.accessBindings.batchUpdate
accounts.accessBindings.batchGet
properties.accessBindings.create
properties.accessBindings.delete
properties.accessBindings.patch
properties.accessBindings.list
properties.accessBindings.get
properties.accessBindings.batchCreate
properties.accessBindings.batchDelete
properties.accessBindings.batchUpdate
properties.accessBindings.batchGet
這項功能可讓您管理 GA4 帳戶或資源的使用者權限,應使用於「使用者連結」,而非「使用者連結」。
2023 年 6 月 1 日起,Admin API v1 Alpha 版的使用者連結功能將遭到移除
2023 年 2 月 24 日 淘汰使用者權限稽核方法。
下列方法已淘汰,並將於 2023 年 6 月 1 日從 Admin API v1 Alpha 中移除:
2023 年 2 月 24 日 新增目標對像管理方法。
Audience
資源已新增至 API 的 v1alpha 版本,以及對應的 properties.audience.create
、properties.audience.archive
、properties.audience.patch
、properties.audience.list
、properties.audience.get
作業。
這項功能可讓您管理 GA4 資源的目標對象。
2023 年 2 月 15 日 新增自動化的 GA4 設定程序選擇不採用方法。
properties.setAutomatedGa4ConfigurationOptOut
、properties.fetchAutomatedGa4ConfigurationOptOut
作業已新增至 API 的 v1alpha 版本。
這項功能可讓您管理通用 Analytics (分析) 資源的自動 GA4 設定程序停用狀態。
2023-02-15 新增了 BigQuery 連結管理方法。
BigQueryLink
資源已新增至 API 的 v1alpha 版本,以及對應的 properties.bigQueryLinks.get
、properties.bigQueryLinks.list
作業。
這項功能可擷取 GA4 資源與 BigQuery 專案之間連結的相關資訊。
2023 年 2 月 15 日 新增 Search Ads 360 連結管理方式。
SearchAds360Link
資源已新增至 API 的 v1alpha 版本,以及對應的 properties.searchAds360Links.create
、properties.searchAds360Links.delete
、properties.searchAds360Links.patch
、properties.searchAds360Links.list
、properties.searchAds360Links.get
作業。
這項功能可讓您管理 GA4 資源和 Search Ads 360 實體之間的連結。
2023 年 2 月 15 日:破壞性變更。
LESS_THAN_OR_EQUAL
、GREATER_THAN_OR_EQUAL
值已從NumericFilter.Operation
列舉中移除。PARTIAL_REGEXP
值已從StringFilter.MatchType
列舉中移除。
2023-02-15 其他異動。
tokensPerProjectPerHour
欄位已新增至AccessQuota
類型。EXPANDED_DATA_SET
、CHANNEL_GROUP
值已新增至ChangeHistoryResourceType
列舉。- 已將
searchAds360Link
、expandedDataSet
和bigqueryLink
值新增至ChangeHistoryResource
。
2022-08-11 runAccessReport
方法已新增至 Admin API v1alpha。
properties.runAccessReport
方法已新增至 Admin API 的 v1alpha 版本。會傳回資料存取記錄的自訂報表。每次使用者讀取 Google Analytics (分析) 報表資料時,此報表都會記載。Google Analytics (分析) 360 資源的管理員可以存取資料存取報表。
發布 2022-07-11 Admin API v1beta 版本。
Google Analytics Admin API 現已推出 v1beta 版。
API 的 Alpha 和 Beta 版本仍持續支援 Admin API。Beta 版包含 Alpha 中部分功能的子集,這類功能視為穩定版,未來預計不會發生重大變更。待新功能達到測試限制後,我們就會在 Beta 版中新增功能。
2021 年 10 月 12 日 已從 API 中移除 EnhancedMeasurementSettings 方法。
properties.webDataStreams.getEnhancedMeasurementSettings
、properties.webDataStreams.updateEnhancedMeasurementSettings
方法已從 API 中移除,但不久之後,您就能透過 API 再次修改加強型評估設定。UserLink
資源的directRoles
欄位不再支援predefinedRoles/manage-users
角色。請改用新的predefinedRoles/admin
角色,這等同於舊版predefinedRoles/edit
和predefinedRoles/manage-users
角色的組合。這項變更會影響accounts.userLinks
和properties.userLinks
方法的行為,與 Google Analytics (分析) 導入的「存取權和資料限制管理」變更一致。
2021-06-05 新增的功能。
API 新增了以下功能:
accounts.searchChangeHistoryEvents
方法已新增至 API。這個方法會根據指定篩選器組合,搜尋帳戶或其子項的所有變更。常見原因可能是在 Google Analytics (分析) UI 中更新、來自客戶支援服務的變更,或是 Google Analytics (分析) 系統自動變更。- 在
properties.webDataStreams.measurementProtocolSecrets
中新增 Measurement Protocol 密鑰管理方法: - 在
properties.conversionEvents
底下新增的轉換事件管理方法: - 在
properties.customDimensions
中新增自訂維度管理方式: - 在
properties.customMetrics
中新增自訂指標管理方法: - 新增
properties.getGoogleSignalsSettings
和properties.updateGoogleSignalsSettings
方法,可控制 Google Analytics (分析) 4 資源的 Google 信號設定。 delete_time
、expire_time
僅供輸出已新增至Property
類型的欄位。
2021 年 6 月 5 日:破壞性變更。
導入以下破壞性變更:
properties.iosAppDataStreams.create
、properties.androidAppDataStreams.create
方法已從 API 中移除。請使用 Firebase 在 Google Analytics (分析) 4 資源中建立應用程式串流。properties.delete
方法現在會將已刪除的屬性資料以Property
類型傳回,而不是傳回空白回應。Property
類型的time_zone
欄位現在為必要欄位。deleted
欄位已從Property
類型中移除。UserLink
類型的email_address
欄位現在無法變更。UserLink
類型的name
欄位現在僅供輸出。
2021-01-28 已新增 ListFirebaseLinks
作業的分頁支援。
2021 年 1 月 28 日:破壞性變更。
破壞性變更:
- 所有更新作業都必須提供 update_mask
欄位。
Account
中的country_code
欄位已重新命名為region_code
。EnhancedMeasurementSettings
中的url_query_parameter
欄位已重新命名為uri_query_parameter
。已從
GoogleAdsLink
中移除「parent
」欄位。
2020 年 10 月 20 日 新增帳戶摘要支援功能。
新增對帳戶摘要方法的支援。
2020 年 10 月 13 日應用程式 + 網站資源已重新命名為 Google Analytics (分析) 4 (GA4)。
2020 年 8 月 15 日 Management App + Web API 已重新命名為 Admin API。
Google Analytics (分析) Management App + Web API 已重新命名為 Google Analytics Admin API。因此,API 端點已變更為 analyticsadmin.googleapis.com。現有針對舊版 API 端點網址所編寫的程式碼和用戶端程式庫就需要隨之更新。