變更記錄

如需 Google Analytics API 官方公告，請前往 Google Analytics API 通知群組。

2024-08-01 新增 BigQuery 連結管理功能

已新增 CreateBigQueryLink、UpdateBigQueryLink 和 DeleteBigQueryLink 管理 BigQueryLink 資源 Admin API v1alpha

已將 dataset_location 欄位新增至 BigQueryLink 資源。

在新的 BIGQUERY_LINK 下將 BigQuery 連結變更記錄新增至變更記錄 值 ChangeHistoryResourceType。

2024-08-01 對 createSubproperty 方法的破壞性變更

createSubproperty 自訂方法已重新命名為 provisionSubproperty 以配合自訂方法 指南。

2024-08-01 新增事件編輯規則管理功能

GetEventEditRule、 CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, 方法。

EventEditRule 用於定義觸發條件建立程序的 新建的事件。此外， EventEditRule 可以定義來源中的參數修改內容 活動。

2024-08-01 其他變更

已將 create_time 新增至 Audience 資源。

已將 primary 新增至 將 ChannelGroup 項資源的資源 指出該管道群組是否為報表的預設管道群組。僅限 1 個 管道群組的「primary」隨時可以設為「true」。設定 管道群組的「primary」為「true」會自動將「primary」設為 false 先前的主要管道群組

已將 gmp_organization 新增至 Account 資源，其中包含 Google Marketing Platform 機構組織的 URI 資源。

2024-05-06 新增重要事件管理方法

金鑰的資源和方法 活動。

修改 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-05：具有「最初點擊」、「線性」、「時間衰減」和「根據排序」歸因模式的資源預設為跨管道以數據為準歸因功能。

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

如果資源目前設為使用其中一種模式， 則會變更為 跨管道以數據為準歸因功能。 您仍然保有 使用「跨管道最終點擊」或「優先計入 Google Ads」(最終點擊) 的選項 改為點擊

2023-09-01 新增 SKAdNetwork 轉換價值結構定義設定方法。

GetSKAdNetworkConversionValueSchema、 CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas 方法。

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

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 在 AttributionSettings 類型中新增 ads_web_conversion_data_export_scope 欄位

已將 ads_web_conversion_data_export_scope 欄位新增至 AttributionSettings 類型，可使用 UpdateAttributionSettings敬上 方法。

2023-06-05 淘汰「最初點擊」、「線性」、「時間衰減」和「根據排序」歸因模式。

自 2023 年 6 月起，UpdateAttributionSettings 方法無法用於設定 GA4 資源的 最初點擊、 線性、 時間衰減 和根據排序 歸因模式自 2023 年 9 月起，這些模式將會 此屬性可供所有資源使用

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

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

GetAdSenseLink、 CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks 方法。

這項功能可用來管理 AdSense 與 Analytics 的連結 Google Analytics 4 資源

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

FetchConnectedGa4Property 方法新增至 Admin API v1alpha

這項功能可用來取得 已連結通用 Analytics 資源的 GA4 資源 測試期間。

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

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

這項功能 事件建立規則 這樣就能根據比對內容來建立新事件 輸入來源事件的條件

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 年 3 月 31 日 新增已連結的網站代碼管理方法。

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

這項功能可讓您管理已連結的網站代碼，很適合用來將通用 Analytics 資源的流量轉送至 Google Analytics 4 資源。

2023-03-31 在 Admin API v1beta 中新增帳戶和資源層級的 runAccessReport 方法。

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

2023 年 2 月 24 日 新增展開資料集管理方法。

ExpandedDataSet 已將資源與對應的 properties.expandedDataSets.create 新增至 API 的 v1alpha 版本。 properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list、 properties.expandedDataSets.get 作業。這項功能可用於管理 Google Analytics 360 中的展開資料集。

2023-02-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 帳戶的使用者權限 ，而不是 User Links。

使用者連結功能將遭到移除 使用 Admin API v1 Alpha 版 (2023 年 6 月 1 日推出)

2023 年 2 月 24 日 淘汰使用者權限稽核方法。

下列方法已淘汰，並將從 Admin API 第 1 版中移除 Alpha 版 2023 年 6 月 1 日

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

2023 年 2 月 24 日：新增目標對像管理方法，

Audience 已將資源與對應的 properties.audience.create 新增至 API 的 v1alpha 版本。 properties.audience.archive, properties.audience.patch, properties.audience.list、 properties.audience.get 作業。

這項功能可讓您管理 GA4 資源的目標對象。

2023 年 2 月 15 日：新增自動化 GA4 設定程序的停用方法。

properties.setAutomatedGa4ConfigurationOptOut、 在 API v1alpha 版本中加入 properties.fetchAutomatedGa4ConfigurationOptOut 作業。

這項功能可讓您管理 GA4 自動化的停用狀態 設定程序 通用 Analytics 資源

2023 年 2 月 15 日 新增 BigQuery 連結管理方法。

BigQueryLink 已將資源新增至 API 的 v1alpha 版本，以及 相應的 properties.bigQueryLinks.get properties.bigQueryLinks.list 作業。

這項功能可讓您擷取 GA4 資源與 BigQuery 專案之間的連結。

2023-02-15 新增 Search Ads 360 連結管理方法。

SearchAds360Link 已將資源與對應的 properties.searchAds360Links.create 新增至 API 的 v1alpha 版本。 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敬上 列舉。

• 已從「StringFilter.MatchType」移除「PARTIAL_REGEXP」值 列舉。

2023 年 2 月 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 版本發布。

v1beta 版 Google Analytics Admin API 已經發布。

管理員會繼續支援 API 的 Alpha 和 Beta 管道 也能使用 Google Cloud CLI 或 Compute Engine APIBeta 版包含 Alpha 版的部分功能， 通常不會大幅變動 Beta 版功能一旦準備就緒，就會加入 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 使用者介面中更新 支援或自動 Google Analytics 系統變更。
• Measurement Protocol 密鑰管理方法已加進 properties.webDataStreams.measurementProtocolSecrets：
  • 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 信號的方法 Google Analytics 4 資源的設定
• delete_time、 expire_time 新增至 Property 的僅限輸出欄位 類型。

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

導入的破壞性變更如下：

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

2021 年 1 月 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 管理應用程式 + Web API 已重新命名為 Google Analytics Admin API因此，API 端點已變更為 analyticsadmin.googleapis.com.針對前一版本撰寫的現有程式碼 API 端點網址和用戶端程式庫需要據此更新。