有关 Google Analytics API 的官方公告，请订阅 Google Analytics API 通知群组。
2024 年 9 月 9 日 访问权限报告调查问卷表单
有关
runAccessReport
方法进行了更新，添加了一个指向
Google Analytics 访问报告反馈
表单。我们非常重视您的意见，并鼓励您分享自己对此问题的想法
帮助我们进一步改进该 API。
2024 年 8 月 1 日 添加了 BigQuery 关联管理
添加了 CreateBigQueryLink、UpdateBigQueryLink 和 DeleteBigQueryLink
管理 Deployment 的
BigQueryLink 项资源
Admin API v1alpha 版。
向 BigQueryLink 资源添加了 dataset_location 字段。
在新的BIGQUERY_LINK下，向更改历史记录添加了 BigQuery 关联更改
值
ChangeHistoryResourceType。
2024 年 8 月 1 日：对 createSubproperty 方法的重大更改
将 createSubproperty 自定义方法重命名为
provisionSubproperty
，以与自定义方法
指南。
2024 年 8 月 1 日 添加了事件修改规则管理
GetEventEditRule、
CreateEventEditRule,
DeleteEventEditRule,
ListEventEditRules,
UpdateEventEditRules,
ReorderEventEditRules,
Admin API v1alpha 版中新增的一些方法。
EventEditRule 定义了触发创建
根据来源事件的匹配条件创建全新的事件。此外，
EventEditRule 可以定义对来源中的参数的修改
事件。
2024 年 8 月 1 日 其他变更
将 create_time 添加到了
Audience 资源。
将 primary 添加到了
ChannelGroup 资源
指明该渠道组是否为报告的默认渠道组。仅一个
渠道组在任何给定时间都可以将 primary 设置为 true。设置
渠道组的 primary 到 true 会自动将 primary 设置为 false
之前的主要渠道组。
向 Account 添加了 gmp_organization
资源，其中包含 Google Marketing Platform 组织的 URI
资源。
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 日：对于采用“首次点击”“线性”“时间衰减”和“根据位置”归因模型的媒体资源，默认采用跨渠道以数据为依据的归因模型。
从 2023 年 10 月中旬开始，首次点击 线性、 时间衰减 和根据位置 归因模型将无法与 UpdateAttributionSettings 搭配使用 方法。
如果您的媒体资源当前配置为使用上述模式之一， 它将被更改为 以数据为依据的跨渠道归因。 您仍然可以 使用“跨渠道最终点击”或“首选 Google Ads 最终转化”选项 点击。
2023 年 9 月 1 日 添加了 SKAdNetwork 转化价值架构配置方法。
向 Admin API v1alpha 添加了 GetSKAdNetworkConversionValueSchema、CreateSKAdNetworkConversionValueSchema、DeleteSKAdNetworkConversionValueSchema、UpdateSKAdNetworkConversionValueSchema、ListSKAdNetworkConversionValueSchemas 方法。
此功能可用于管理 SKAdNetwork 转化价值架构 配置 。
2023-09-01 添加了 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 将进行重大更改 而这会影响 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 年 6 月 弃用“首次点击”“线性”“时间衰减”和“根据位置”归因模型。
从 2023 年 6 月开始，您可以使用 UpdateAttributionSettings 方法不能用于配置 GA4 媒体资源 首次点击、 线性广告、 时间衰减 和根据位置 归因模型。自 2023 年 9 月起，这些模型将变为 不适用于所有媒体资源。
请参阅 Google Analytics 产品公告 。
2023 年 5 月 31 日 添加了 AdSense 关联管理方法。
GetAdSenseLink、
CreateAdSenseLink,
DeleteAdSenseLink,
ListAdSenseLinks
Admin API v1alpha 版中新增的一些方法。
此功能可管理AdSense 与 Google Analytics 之间的关联 。
2023 年 5 月 31 日 添加了用于查找关联的 GA4 媒体资源的方法。
FetchConnectedGa4Property
Admin API v1alpha 版中添加了 方法
通过此功能，您可以获取 GA4 媒体资源已关联您的 Universal Analytics 媒体资源 进行迁移。
2023 年 5 月 31 日 添加了管理事件创建规则的方法。
CreateEventCreateRule、
UpdateEventCreateRule,
DeleteEventCreateRule,
ListEventCreateRules,
GetEventCreateRule 方法已添加到 Admin API v1alpha 中。
借助此功能，您可以管理事件创建规则，这些规则可根据与来源事件匹配的条件触发全新事件的创建。
2023 年 5 月 31 日 添加了管理自定义渠道组的方法。
添加了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 方法。
properties.runAccessReport
和accounts.runAccessReport
v1beta 版 Admin API 中新增了一些方法。方法会返回一个
自定义的数据访问记录报告。
2023 年 2 月 24 日 添加了展开式数据集管理方法。
ExpandedDataSet
v1alpha 版中的资源以及相应的 properties.expandedDataSets.create，
properties.expandedDataSets.delete,
properties.expandedDataSets.patch,
properties.expandedDataSets.list,
properties.expandedDataSets.get
操作。此功能可用于在 Google Analytics 360 中管理展开式数据集。
2023 年 2 月 24 日：访问权限绑定将取代用户关联，用于管理用户权限。
AccessBinding
v1alpha 版 API，以及
以下操作：
accounts.accessBindings.createaccounts.accessBindings.deleteaccounts.accessBindings.patchaccounts.accessBindings.listaccounts.accessBindings.getaccounts.accessBindings.batchCreateaccounts.accessBindings.batchDeleteaccounts.accessBindings.batchUpdateaccounts.accessBindings.batchGetproperties.accessBindings.createproperties.accessBindings.deleteproperties.accessBindings.patchproperties.accessBindings.listproperties.accessBindings.getproperties.accessBindings.batchCreateproperties.accessBindings.batchDeleteproperties.accessBindings.batchUpdateproperties.accessBindings.batchGet
此功能可用于管理 GA4 账号的用户权限，或 属性，而不是用户关联。
用户关联功能将被移除 已于 2023 年 6 月 1 日推出 Admin API v1 Alpha 版
2023 年 2 月 24 日 弃用用户权限审核方法。
以下方法已弃用，并将从 Admin API v1 中移除 于 2023 年 6 月 1 日发布的 Alpha 版：
2023 年 2 月 24 日：新增了受众群体管理方法。
Audience
v1alpha 版中的资源以及相应的 properties.audience.create，
properties.audience.archive,
properties.audience.patch,
properties.audience.list,
properties.audience.get
操作。
借助此功能，您可以管理 GA4 媒体资源的受众群体。
2023 年 2 月 15 日 添加了自动停用 GA4 设置流程的方法。
properties.setAutomatedGa4ConfigurationOptOut、
v1alpha 版 API 中新增了 properties.fetchAutomatedGa4ConfigurationOptOut 操作。
借助此功能，您可以管理自动化 GA4 的停用状态 设置流程 为 UA 媒体资源。
2023 年 2 月 15 日 添加了 BigQuery 关联管理方法。
BigQueryLink
v1alpha 版 API，以及
相应的 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枚举。已从
StringFilter.MatchType中移除“PARTIAL_REGEXP”值 枚举。
2023 年 2 月 15 日 其他变更。
- 向
AccessQuota添加了tokensPerProjectPerHour字段 类型。 EXPANDED_DATA_SET，CHANNEL_GROUP值已添加到ChangeHistoryResourceType枚举。- 向
ChangeHistoryResource添加了searchAds360Link、expandedDataSet、bigqueryLink值。
2022 年 8 月 11 日：向 Admin API v1alpha 添加了 runAccessReport 方法。
properties.runAccessReport
方法已添加到 v1alpha 版 Admin API 中。它会返回一个
数据访问记录的自定义报告。该报告会提供
当用户读取 Google Analytics 报告数据时触发。数据访问权限报告
。
2022 年 7 月 11 日发布了 Admin API v1beta 版本。
管理员可继续支持 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 中新增了以下功能：
accounts.searchChangeHistoryEvents方法已添加到 API 中此方法会搜索对 账号或其子账号。常见原因 可能是在 Google Analytics 界面中进行的更新、 或 Google Analytics 系统自动更改。- 下面添加了 Measurement Protocol 密钥管理方法
properties.webDataStreams.measurementProtocolSecrets: - 在
properties.conversionEvents下添加的转化事件管理方法： - 在
properties.customDimensions下添加的自定义维度管理方法： - 添加自定义指标管理方法
properties.customMetrics: - 添加了
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_zoneProperty的 type 现已成为必需属性。- 已从
Property中移除“deleted”字段 类型。 email_addressUserLink的 type 现在不可变。nameUserLink的 类型现在只是输出。
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“应用 + 网站”API 已更名为 Admin API。
Google Analytics Management App + Web API 已重命名为 Google Analytics Admin API。因此，API 端点已更改为 analyticsadmin.googleapis.com.使用先前版本编写的现有代码 API 端点网址和客户端库进行相应更新。