變更記錄

如要查看 Google Analytics API 的官方公告，請訂閱 Google Analytics API 通知群組。

2026 年 6 月 18 日：新增 UpdateReportingIdentitySettings 方法

• 在 Admin API v1alpha 中新增 UpdateReportingIdentitySettings 方法，可更新資源的 ReportingIdentitySettings。

2026 年 6 月 18 日：在「PropertySummary」中新增「can_edit」欄位

• 在 Admin API v1alpha 和 v1beta 中，將 can_edit 欄位新增至 PropertySummary 資源。這個欄位會指出使用者是否具備 Google Analytics 角色，可變更資源設定。

2026-04-14 新增 GetUserProvidedDataSettings 方法

• 在 Admin API v1alpha 中新增 GetUserProvidedDataSettings 方法，可擷取資源的 UserProvidedDataSettings。

• 在 Admin API v1alpha 中新增 UserProvidedDataSettings 資源，其中包含使用者提供的資料收集欄位 userProvidedDataCollectionEnabled 和 automaticallyDetectedDataCollectionEnabled。

2025-08-20 新增 GetReportingIdentitySettings 方法

在 Admin API v1alpha 中新增 GetReportingIdentitySettings 方法，可擷取資源的 ReportingIdentitySettings。

2025 年 8 月 20 日：移除舊版通用 Analytics 方法

下列舊版通用 Analytics 方法已從 Admin API v1alpha 中移除：SetAutomatedGa4ConfigurationOptOut、FetchAutomatedGa4ConfigurationOptOut、CreateConnectedSiteTag、DeleteConnectedSiteTag、ListConnectedSiteTags 和 FetchConnectedGa4Property。

2025 年 6 月 12 日：新增子資源同步設定管理方法

新增 GetSubpropertySyncConfig、ListSubpropertySyncConfig 和 UpdateSubpropertySyncConfig 方法，透過 Admin API v1alpha 管理 SubpropertySyncConfig 資源。

2025 年 4 月 16 日：新增報表資料註解管理方法

新增 CreateReportingDataAnnotation、GetReportingDataAnnotation、ListReportingDataAnnotations、UpdateReportingDataAnnotation 和 DeleteReportingDataAnnotation 方法，可透過 Admin API v1alpha 管理 ReportingDataAnnotation 資源。

使用者可以透過備註，直接在 Google Analytics 報表中加入附註，輕鬆記錄事件、說明資料變化，或為自己和團隊醒目顯示重要觀察結果。

2025 年 3 月 7 日：淘汰 sharingWithGoogleAnySalesEnabled 參數

getDataSharingSettings 方法的 sharingWithGoogleAnySalesEnabled 參數現已淘汰，且一律會傳回 false。這個欄位將於 2025 年 6 月從 Google Analytics 管理 API v1beta 中移除。

2025 年 1 月 20 日：在 DataRetentionSettings 中新增使用者資料保留功能

在 Admin API v1alpha 和 v1beta 中，已將 userDataRetention 欄位新增至 DataRetentionSettings。使用這個欄位擷取或修改使用者資料的保留設定。

2024-09-09 存取報表問卷表單

runAccessReport 方法的文件已更新，現在包含「Google Analytics 存取報表意見回饋」表單的連結。我們很重視您的想法，歡迎分享對這項 API 的看法，協助我們進一步改良。

2024 年 8 月 1 日：新增 BigQuery 連結管理功能

新增 CreateBigQueryLink、UpdateBigQueryLink 和 DeleteBigQueryLink 方法，可透過 Admin API v1alpha 管理 BigQueryLink 資源。

在 BigQueryLink 資源中加入 dataset_location 欄位。

在「變更記錄」下方的新 BIGQUERY_LINK值中，新增 BigQuery 連結變更ChangeHistoryResourceType。

2024 年 8 月 1 日：createSubproperty 方法的破壞性變更

在 Admin API v1alpha 中，將 createSubproperty 自訂方法重新命名為 provisionSubproperty，以符合自訂方法指南。

2024 年 8 月 1 日：新增活動編輯規則管理功能

GetEventEditRule、CreateEventEditRule、DeleteEventEditRule、ListEventEditRules、UpdateEventEditRules、ReorderEventEditRules 方法已新增至 Admin API v1alpha。

EventEditRule定義的條件會根據來源事件的相符條件，觸發建立全新的事件。此外，EventEditRule 可以定義來源事件的參數修改項目。

2024 年 8 月 1 日：其他變更

將 create_time 新增至 Audience 資源。

在 ChannelGroup 資源中新增 primary，指出管道群組是否為報表的預設管道群組。在任何時間，只有一個頻道群組的 primary 可以設為 true。將管道群組的 primary 設為 true 時，系統會自動將先前主要管道群組的 primary 設為 false。

在 Account 資源中新增 gmp_organization，其中包含 Google Marketing Platform 機構資源的 URI (如果帳戶已連結至 GMP 機構)。

2024 年 5 月 6 日：新增重要事件管理方法

現在提供重要事件的資源和方法。

修改 API 整合功能，改用 KeyEvent，而非 ConversionEvent。ConversionEvent 已淘汰。

2023 年 12 月 15 日：所有 Google Analytics 資源現在都能使用資料存取報表。

所有 Google Analytics 資源 (包括標準版和 Google Analytics 360) 的客戶，現在都能使用資料存取報表功能的特定欄位。

詳情請參閱結構定義說明文件。

2023 年 12 月 15 日：資料存取報表結構定義新增 accessDateHour 維度。

已在資料存取報表結構定義中新增 accessDateHour 維度。其中包含 Google Analytics 使用者存取 Google Analytics 報表資料的日期時間。

2023 年 10 月 5 日：如果資源使用「最初點擊」、「線性」、「時間衰減」和「根據排序」歸因模式，系統會預設為跨管道 DDA。

自 2023 年 10 月中旬起，所有資源的 最初點擊、線性、時間衰減和根據排序歸因模式，都無法再搭配 UpdateAttributionSettings 方法使用。

如果資源目前設定使用這些模式，系統會改用跨管道以數據為準歸因。您還是可以選擇改用跨管道最終點擊或優先計入 Google Ads 最終點擊。

2023 年 9 月 1 日：新增 SKAdNetwork 轉換價值結構定義設定方法。

GetSKAdNetworkConversionValueSchema、CreateSKAdNetworkConversionValueSchema、DeleteSKAdNetworkConversionValueSchema、UpdateSKAdNetworkConversionValueSchema、ListSKAdNetworkConversionValueSchemas 方法已新增至 Admin API v1alpha。

這項功能可管理 iOS 串流的 SKAdNetwork 轉換價值結構定義設定。

2023 年 9 月 1 日：新增 UpdateConversionEvent 方法。

UpdateConversionEvent 方法已新增至 Admin API v1beta。

2023 年 9 月 1 日：「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 第 1 版 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 年 7 月 10 日：在 AttributionSettings 型別中新增 ads_web_conversion_data_export_scope 欄位

已將 ads_web_conversion_data_export_scope 欄位新增至 AttributionSettings 型別，可使用 UpdateAttributionSettings 方法修改。

2023 年 6 月 5 日：停用「最初點擊」、「線性」、「時間衰減」和「根據排序」歸因模式。

自 2023 年 6 月起，您無法使用 UpdateAttributionSettings 方法，為 GA4 資源設定「最初點擊」、「線性」、「時間衰減」和「根據排序」歸因模式。自 2023 年 9 月起，所有資源都將無法使用這些模式。

詳情請參閱 Google Analytics 產品公告。

2023 年 5 月 31 日：新增 AdSense 連結管理方法。

GetAdSenseLink、CreateAdSenseLink、DeleteAdSenseLink、ListAdSenseLinks 方法已新增至 Admin API v1alpha。

這項功能可管理 GA4 資源的 AdSense 與 Analytics 連結。

2023 年 5 月 31 日：新增了用於查詢已連結 GA4 資源的方法。

已將 FetchConnectedGa4Property 方法新增至 Admin API v1alpha

這項功能可讓您在 GA4 遷移程序中，取得已連結至通用 Analytics 資源的 GA4 資源相關資訊。

2023 年 5 月 31 日：新增管理事件建立規則的方法。

新增至 Admin API v1alpha 的 CreateEventCreateRule、UpdateEventCreateRule、DeleteEventCreateRule、ListEventCreateRules、GetEventCreateRule 方法。

這項功能可管理事件建立規則，根據來源事件的相符條件觸發建立全新事件。

2023 年 5 月 31 日：新增管理自訂管道群組的方法。

在 Admin API v1alpha 中新增 GetChannelGroup、ListChannelGroups、CreateChannelGroup、UpdateChannelGroup、DeleteChannelGroup 方法。

這項功能可讓您管理網站流量來源的自訂管道群組。

建立完成後，即可使用 Google Analytics Data API v1 查詢自訂管道群組。

2023-03-31：新增加強型評估設定管理方法。

Admin API v1alpha 新增 properties.dataStreams.updateEnhancedMeasurementSettings 和 properties.dataStreams.getEnhancedMeasurementSettings 方法。

這項功能可管理 GA4 資源網站資料串流的加強型評估設定。

2023 年 3 月 31 日：新增已連結網站代碼的管理方法。

新增至 Admin API v1alpha 的 properties.createConnectedSiteTag、properties.deleteConnectedSiteTag、properties.listConnectedSiteTags 方法。

這項功能可管理已連結的網站代碼，並將流量從通用 Analytics 資源轉送至 Google Analytics 4 資源。

2023 年 3 月 31 日：在 Admin API v1beta 中新增帳戶和資源層級的 runAccessReport 方法。

已將 properties.runAccessReport 和 accounts.runAccessReport 方法新增至 Admin API 的 v1beta 版。方法會傳回資料存取記錄的自訂報表。

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

這項功能可管理 Google Analytics 4 帳戶或資源的使用者權限，應取代「使用者連結」。

使用者連結功能將於 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 年 2 月 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 日：破壞性變更。

• 從 NumericFilter.Operation 列舉中移除 LESS_THAN_OR_EQUAL、GREATER_THAN_OR_EQUAL 值。

• 從 StringFilter.MatchType 列舉中移除 PARTIAL_REGEXP 值。

2023 年 2 月 15 日：其他變更。

• 已在 AccessQuota 類型中新增 tokensPerProjectPerHour 欄位。
• EXPANDED_DATA_SET、CHANNEL_GROUP 值已新增至 ChangeHistoryResourceType 列舉。
• 已將 searchAds360Link、expandedDataSet、bigqueryLink 值新增至 ChangeHistoryResource。

2022 年 8 月 11 日：Admin API v1alpha 新增 runAccessReport 方法。

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 年 6 月 5 日：新增功能。

API 新增下列功能：

• API 中新增了 accounts.searchChangeHistoryEvents 方法。這個方法會根據指定的篩選條件組合，搜尋帳戶或其子項的所有變更。常見原因包括在 Google Analytics 使用者介面中進行更新、客戶支援團隊進行變更，或是 Google Analytics 系統自動變更。
• 在 properties.dataStreams.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 output only fields added to the Property type.

2021 年 6 月 5 日：破壞性變更。

我們導入了下列破壞性變更：

• API 中已移除 properties.iosAppDataStreams.create、properties.androidAppDataStreams.create 方法。請使用 Firebase 在 Google Analytics 4 資源中建立應用程式串流。
• properties.delete 方法現在會以 Property 型別傳回已刪除的屬性資料，而不是傳回空白回應。
• time_zone 現在必須提供 Property 類型的欄位。
• 已從「Property」類型中移除「deleted」欄位。
• email_address UserLink 類型的欄位現在無法變更。
• name 系統現在只會輸出 UserLink 類型的欄位。

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 日：管理應用程式 + 網站資源已重新命名為 Admin API。

Google Analytics 管理應用程式 + 網站 API 已重新命名為 Google Analytics Admin API。因此，API 端點已變更為 analyticsadmin.googleapis.com。針對先前版本的 API 端點網址和用戶端程式庫編寫的現有程式碼，都必須一併更新。