更新日志

如需获取官方 Google Analytics(分析)API 公告,请订阅 Google Analytics(分析)API 通知群组

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 转化价值架构配置方法。

向 Admin API v1alpha 添加了 GetSKAdNetworkConversionValueSchemaCreateSKAdNetworkConversionValueSchemaDeleteSKAdNetworkConversionValueSchemaUpdateSKAdNetworkConversionValueSchemaListSKAdNetworkConversionValueSchemas 方法。

借助此功能,您可以为 iOS 数据流管理 SKAdNetwork 转化价值架构配置

2023 年 9 月 1 日 添加了 UpdateConversionEvent 方法。

Admin API v1beta 中添加了 UpdateConversionEvent 方法。

2023-09-01 BigQueryLink.enterprise_export_enabled 字段已重命名为 fresh_daily_export_enabled

BigQueryLink 资源的 enterprise_export_enabled 字段已重命名为 fresh_daily_export_enabled

2023 年 7 月 14 日properties.updateAttributionSettingsproperties.getAttributionSettings 方法的重大更改。

自 2023 年 7 月 24 日起,我们将对 Admin API v1 Alpha 版进行破坏性更改,这将影响 properties.getAttributionSettingsproperties.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 字段

AttributionSettings 类型添加了 ads_web_conversion_data_export_scope 字段,该字段可使用 UpdateAttributionSettings 方法进行修改。

2023 年 6 月 5 日:弃用“首次点击”“线性”“时间衰减”和“根据位置”归因模型。

自 2023 年 6 月起,不得使用 UpdateAttributionSettings 方法配置采用首次点击线性时间衰减根据位置归因模型的 GA4 媒体资源。从 2023 年 9 月起,这些模型将不再适用于所有媒体资源。

有关详情,请参阅 Google Analytics(分析)产品公告

向 Admin API v1alpha 添加了 GetAdSenseLinkCreateAdSenseLinkDeleteAdSenseLinkListAdSenseLinks 方法。

借助此功能,您可以为 GA4 媒体资源管理 AdSense 与 Google Analytics(分析)之间的关联

2023 年 5 月 31 日:添加了用于查找已关联的 GA4 媒体资源的方法。

Admin API v1alpha 中添加了 FetchConnectedGa4Property 方法

此功能可用于在 GA4 迁移过程中获取与您的 Universal Analytics 媒体资源关联的 GA4 媒体资源的相关信息。

2023 年 5 月 31 日:添加了管理事件创建规则的方法。

向 Admin API v1alpha 添加了 CreateEventCreateRuleUpdateEventCreateRuleDeleteEventCreateRuleListEventCreateRulesGetEventCreateRule 方法。

借助此功能,您可以管理事件创建规则,这些规则可以根据来源事件的匹配条件触发创建全新事件。

2023 年 5 月 31 日:添加了管理自定义渠道组的方法。

向 Admin API v1alpha 添加了 GetChannelGroupListChannelGroupsCreateChannelGroupUpdateChannelGroupDeleteChannelGroup 方法。

借助此功能,您可以针对网站流量来源管理自定义渠道组

创建自定义渠道组后,您可以使用 Google Analytics(分析)Data API v1 进行查询。

2023 年 3 月 31 日:添加了增强型衡量设置管理方法。

向 Admin API v1alpha 添加了 properties.dataStreams.updateEnhancedMeasurementSettingsproperties.dataStreams.getEnhancedMeasurementSettings 方法。

借助此功能,您可以为 GA4 媒体资源的网站数据流管理增强型衡量设置

2023 年 3 月 31 日:添加了已关联的网站代码管理方法。

向 Admin API v1alpha 添加了 properties.createConnectedSiteTagproperties.deleteConnectedSiteTagproperties.listConnectedSiteTags 方法。

此功能支持管理已关联的网站代码,并且有助于将流量从 Universal Analytics 媒体资源转发到 Google Analytics(分析)4 媒体资源。

2023 年 3 月 31 日:向 Admin API v1beta 添加了帐号和媒体资源级 runAccessReport 方法。

Admin API 的 v1beta 版本中添加了 properties.runAccessReportaccounts.runAccessReport 方法。方法会返回自定义的数据访问记录报告

2023 年 2 月 24 日 添加了展开式数据集管理方法。

ExpandedDataSet 资源以及相应的 properties.expandedDataSets.createproperties.expandedDataSets.deleteproperties.expandedDataSets.patchproperties.expandedDataSets.listproperties.expandedDataSets.get 操作已添加到 API 的 v1alpha 版本中。此功能可用于在 Google Analytics 360 中管理展开式数据集

API 的 v1alpha 版本中添加了 AccessBinding 资源以及以下操作:

此功能可用于管理 GA4 帐号或媒体资源的用户权限,应该使用该功能而不是用户关联

用户链接功能将于 2023 年 6 月 1 日从 Admin API v1 Alpha 版中移除

2023 年 2 月 24 日:弃用了用户权限审核方法。

以下方法已废弃,并将于 2023 年 6 月 1 日从 Admin API v1 Alpha 版中移除:

2023 年 2 月 24 日:添加了受众群体管理方法。

Audience 资源以及相应的 properties.audience.createproperties.audience.archiveproperties.audience.patchproperties.audience.listproperties.audience.get 操作已添加到 API 的 v1alpha 版本中。

借助此功能,您可以为 GA4 媒体资源管理受众群体

2023 年 2 月 15 日:添加了自动停用 GA4 设置流程的方法。

该 API 的 v1alpha 版本中添加了 properties.setAutomatedGa4ConfigurationOptOutproperties.fetchAutomatedGa4ConfigurationOptOut 操作。

借助此功能,您可以管理 UA 媒体资源的自动 GA4 设置流程的选择停用状态

BigQueryLink 资源以及相应的 properties.bigQueryLinks.getproperties.bigQueryLinks.list 操作已添加到 API 的 v1alpha 版本中。

此功能可用于检索有关 GA4 媒体资源与 BigQuery 项目之间的关联的信息。

SearchAds360Link 资源以及相应的 properties.searchAds360Links.createproperties.searchAds360Links.deleteproperties.searchAds360Links.patchproperties.searchAds360Links.listproperties.searchAds360Links.get 操作已添加到 API 的 v1alpha 版本中。

借助此功能,您可以管理 GA4 媒体资源与 Search Ads 360 实体之间的关联。

2023 年 2 月 15 日 重大变更。

2023 年 2 月 15 日 其他变更。

2022 年 8 月 11 日:向 Admin API v1alpha 添加了 runAccessReport 方法。

添加到 Admin API v1alpha 版本的 properties.runAccessReport 方法。它会返回数据访问记录的自定义报告。该报告会提供用户每次读取 Google Analytics(分析)报告数据的记录。Google Analytics 360 媒体资源的管理员可访问数据访问报告。

2022 年 7 月 11 日:发布了 Admin API v1beta 版本。

Google Analytics(分析)Admin API 的 v1beta 版本已发布。

Admin API 继续支持 Alpha 版和 Beta 版 API。Beta 渠道包含 Alpha 版中提供的部分功能,这些功能被视为稳定版功能,预计未来不会有重大更改。新功能在成熟后将添加到 Beta 版中。

2021 年 10 月 12 日:从 API 中移除了 EnhancedMeasurementSettings 方法。

  • properties.webDataStreams.getEnhancedMeasurementSettingsproperties.webDataStreams.updateEnhancedMeasurementSettings 方法已从该 API 中移除,但增强型衡量设置很快将再次可通过 API 进行修改。
  • UserLink 资源的 directRoles 字段不再支持 predefinedRoles/manage-users 角色。您应改用新的 predefinedRoles/admin 角色,该角色等同于旧的 predefinedRoles/editpredefinedRoles/manage-users 角色的组合。此变更会影响 accounts.userLinksproperties.userLinks 方法的行为,并且符合 Google Analytics(分析)中引入的访问权限和数据限制管理变更。

2021 年 6 月 5 日 添加了功能。

API 中新增了以下功能:

2021 年 6 月 5 日 重大变更。

引入了以下破坏性更改:

  • 从 API 中移除了 properties.iosAppDataStreams.createproperties.androidAppDataStreams.create 方法。请使用 Firebase 在 Google Analytics(分析)4 媒体资源中创建应用数据流。
  • properties.delete 方法现在会将已删除的属性数据作为 Property 类型返回,而不是返回空响应。
  • 现在,Property 类型的 time_zone 字段是必填字段。
  • Property 类型中移除了 deleted 字段。
  • UserLink 类型的 email_address 字段现在不可变。
  • 现在,UserLink 类型的 name 字段仅输出。

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 端点网址和客户端库编写的现有代码需要相应地更新。