變更記錄

如需 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 中移除：

• accounts.userLinks.audit
• properties.userLinks.audit

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 密鑰管理方法：
  • create 建立 Measurement Protocol 密鑰。
  • delete 刪除目標 Measurement Protocol 密鑰。
  • get 查詢單一 Measurement Protocol 密鑰。
  • list 傳回指定父項屬性下的子 Measurement Protocol 密鑰。
  • patch 更新 Measurement Protocol 密鑰。
• 在 properties.conversionEvents 底下新增的轉換事件管理方法：
  • create 建立具有指定屬性的轉換事件。
  • delete 刪除資源中的轉換事件。
  • get 擷取單一轉換事件。
  • list 傳回指定父項資源中的轉換事件清單。
• 在 properties.customDimensions 中新增自訂維度管理方式：
  • archive 封存資源中的自訂維度。
  • create 建立自訂維度。
  • get 查詢單一自訂維度。
  • list 列出屬性的自訂維度。
  • patch 更新資源的自訂維度。
• 在 properties.customMetrics 中新增自訂指標管理方法：
  • archive 封存屬性的自訂指標。
  • create 會使用自訂指標。
  • get 查詢單一自訂指標。
  • list 列出屬性的自訂指標。
  • patch 更新屬性的自訂指標。
• 新增 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 端點網址所編寫的程式碼和用戶端程式庫就需要隨之更新。