如需获取官方 Google Analytics(分析)API 公告,请订阅 Google Analytics(分析)API 通知群组。
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 转化价值架构配置方法。
向 Admin API v1alpha 添加了 GetSKAdNetworkConversionValueSchema
、CreateSKAdNetworkConversionValueSchema
、DeleteSKAdNetworkConversionValueSchema
、UpdateSKAdNetworkConversionValueSchema
和 ListSKAdNetworkConversionValueSchemas
方法。
借助此功能,您可以为 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.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 年 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(分析)产品公告。
2023 年 5 月 31 日:添加了 AdSense 关联管理方法。
向 Admin API v1alpha 添加了 GetAdSenseLink
、CreateAdSenseLink
、DeleteAdSenseLink
和 ListAdSenseLinks
方法。
借助此功能,您可以为 GA4 媒体资源管理 AdSense 与 Google Analytics(分析)之间的关联。
2023 年 5 月 31 日:添加了用于查找已关联的 GA4 媒体资源的方法。
Admin API v1alpha 中添加了 FetchConnectedGa4Property
方法
此功能可用于在 GA4 迁移过程中获取与您的 Universal 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 年 3 月 31 日:添加了增强型衡量设置管理方法。
向 Admin API v1alpha 添加了 properties.dataStreams.updateEnhancedMeasurementSettings
和 properties.dataStreams.getEnhancedMeasurementSettings
方法。
借助此功能,您可以为 GA4 媒体资源的网站数据流管理增强型衡量设置。
2023 年 3 月 31 日:添加了已关联的网站代码管理方法。
向 Admin API v1alpha 添加了 properties.createConnectedSiteTag
、properties.deleteConnectedSiteTag
和 properties.listConnectedSiteTags
方法。
此功能支持管理已关联的网站代码,并且有助于将流量从 Universal Analytics 媒体资源转发到 Google Analytics(分析)4 媒体资源。
2023 年 3 月 31 日:向 Admin API v1beta 添加了帐号和媒体资源级 runAccessReport
方法。
Admin API 的 v1beta 版本中添加了 properties.runAccessReport
和 accounts.runAccessReport
方法。方法会返回自定义的数据访问记录报告。
2023 年 2 月 24 日 添加了展开式数据集管理方法。
ExpandedDataSet
资源以及相应的 properties.expandedDataSets.create
、properties.expandedDataSets.delete
、properties.expandedDataSets.patch
、properties.expandedDataSets.list
、properties.expandedDataSets.get
操作已添加到 API 的 v1alpha 版本中。此功能可用于在 Google Analytics 360 中管理展开式数据集。
2023 年 2 月 24 日:访问权限绑定将取代用户关联,以便管理用户权限。
API 的 v1alpha 版本中添加了 AccessBinding
资源以及以下操作:
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
资源以及相应的 properties.audience.create
、properties.audience.archive
、properties.audience.patch
、properties.audience.list
、properties.audience.get
操作已添加到 API 的 v1alpha 版本中。
借助此功能,您可以为 GA4 媒体资源管理受众群体。
2023 年 2 月 15 日:添加了自动停用 GA4 设置流程的方法。
该 API 的 v1alpha 版本中添加了 properties.setAutomatedGa4ConfigurationOptOut
、properties.fetchAutomatedGa4ConfigurationOptOut
操作。
借助此功能,您可以管理 UA 媒体资源的自动 GA4 设置流程的选择停用状态。
2023 年 2 月 15 日 添加了 BigQuery 关联管理方法。
BigQueryLink
资源以及相应的 properties.bigQueryLinks.get
和 properties.bigQueryLinks.list
操作已添加到 API 的 v1alpha 版本中。
此功能可用于检索有关 GA4 媒体资源与 BigQuery 项目之间的关联的信息。
2023 年 2 月 15 日:添加了 Search Ads 360 关联管理方法。
SearchAds360Link
资源以及相应的 properties.searchAds360Links.create
、properties.searchAds360Links.delete
、properties.searchAds360Links.patch
、properties.searchAds360Links.list
、properties.searchAds360Links.get
操作已添加到 API 的 v1alpha 版本中。
借助此功能,您可以管理 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
字段。- 向
ChangeHistoryResourceType
枚举添加了EXPANDED_DATA_SET
和CHANNEL_GROUP
值。 - 向
ChangeHistoryResource
添加了searchAds360Link
、expandedDataSet
、bigqueryLink
个值。
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.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.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 日 重大变更。
引入了以下破坏性更改:
- 从 API 中移除了
properties.iosAppDataStreams.create
和properties.androidAppDataStreams.create
方法。请使用 Firebase 在 Google Analytics(分析)4 媒体资源中创建应用数据流。 properties.delete
方法现在会将已删除的属性数据作为Property
类型返回,而不是返回空响应。- 现在,
Property
类型的time_zone
字段是必填字段。 - 从
Property
类型中移除了deleted
字段。 UserLink
类型的email_address
字段现在不可变。- 现在,
UserLink
类型的name
字段仅输出。
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(分析)Management App + Web API 已更名为 Google Analytics(分析)Admin API。因此,API 端点已更改为 analyticsadmin.googleapis.com。针对旧版 API 端点网址和客户端库编写的现有代码需要相应地更新。