更新日志

如需了解有关 Google Analytics API 的官方公告，请订阅 Google Analytics API Notify 群组。

2026-06-18 添加了 UpdateReportingIdentitySettings 方法

2026-06-18 向 PropertySummary 添加了 can_edit 字段

  • 向 Admin API v1alpha 和 v1beta 中的 PropertySummary 资源添加了 can_edit 字段。此字段用于指明用户是否拥有允许其更改媒体资源设置的 Google Analytics 角色。

2026-04-14 添加了 GetUserProvidedDataSettings 方法

2025-08-20 添加了 GetReportingIdentitySettings 方法

向 Admin API v1alpha 添加了 GetReportingIdentitySettings 方法，可用于检索媒体资源的 ReportingIdentitySettings 。

2025-08-20 移除了旧版 Universal Analytics 方法

以下旧版 Universal Analytics (UA) 方法已从 Admin API v1alpha 中移除：SetAutomatedGa4ConfigurationOptOut、FetchAutomatedGa4ConfigurationOptOut、CreateConnectedSiteTag、DeleteConnectedSiteTag、ListConnectedSiteTags 和 FetchConnectedGa4Property。

2025-06-12 添加了子媒体资源同步配置管理方法

添加了 GetSubpropertySyncConfig、 ListSubpropertySyncConfig和 UpdateSubpropertySyncConfig 方法，以便使用 Admin API v1alpha 管理 SubpropertySyncConfig 资源。

2025-04-16 添加了报告数据注释管理方法

添加了 CreateReportingDataAnnotation、 GetReportingDataAnnotation、 ListReportingDataAnnotations、 UpdateReportingDataAnnotation 和 DeleteReportingDataAnnotation 方法，以便使用 Admin API v1alpha 管理 ReportingDataAnnotation 资源。

借助注释功能，用户可直接在 Google Analytics 报告中添加备注，从而更轻松地记录 事件、说明数据变化，或为自己和团队突出显示关键观察结果。

2025-03-07 弃用了 sharingWithGoogleAnySalesEnabled 参数

sharingWithGoogleAnySalesEnabled 方法的 getDataSharingSettings 参数现已弃用，并且将始终返回 false。该字段将于 2025 年 6 月从 Google Analytics Admin API v1beta 中移除。

2025-01-20 向 DataRetentionSettings 添加了用户数据保留设置

向 DataRetentionSettings中的 Admin API v1alpha 和 v1beta 添加了userDataRetention字段。您可以使用此字段检索或修改用户数据的保留设置。

2024-09-09 访问报告调查表单

更新了 runAccessReport 方法的文档，其中包含指向 Google Analytics 访问报告反馈 表单的链接。我们非常重视您的反馈，并鼓励您分享对此 API 的想法，以帮助我们进一步改进它。

添加了 CreateBigQueryLink、UpdateBigQueryLink 和 DeleteBigQueryLink 方法，以便使用 Admin API v1alpha 管理 BigQueryLink 资源。

向 BigQueryLink 资源添加了 dataset_location 字段。

在新的 BIGQUERY_LINK 值中 ChangeHistoryResourceType下，向更改历史记录添加了 BigQuery 关联更改。

2024-08-01 对 createSubproperty 方法进行了重大更改

在 Admin API v1alpha 中，将 createSubproperty 自定义方法重命名为 provisionSubproperty ，以符合 自定义方法 指南。

2024-08-01 添加了事件修改规则管理功能

GetEventEditRule、 CreateEventEditRule、 DeleteEventEditRule、 ListEventEditRules、 UpdateEventEditRules、 ReorderEventEditRules 方法已添加到 Admin API v1alpha。

EventEditRule 定义了将根据来源事件的匹配条件触发全新事件创建的条件。此外，EventEditRule 还可以定义对来源事件的参数进行的修改。

2024-08-01 其他更改

向 Audience资源添加了create_time。

向 ChannelGroup资源添加了primary，以 指明渠道组是否为报告的默认渠道组。在任何给定时间，只能有一个渠道组将 primary 设置为 true。如果将某个渠道组的 primary 设置为 true，系统会自动将之前的主渠道组的 primary 设置为 false。

向 Account 资源添加了 gmp_organization，其中包含 Google Marketing Platform 组织 资源的 URI（如果账号已关联到 GMP 组织）。

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 采用“首次点击”“线性”“时间衰减”和“根据位置”归因模型的媒体资源默认使用跨渠道 DDA。

自 2023 年 10 月中旬起，所有媒体资源都无法使用 UpdateAttributionSettings 方法来使用“首次点击”“线性”“时间衰减”和“根据位置”归因模型。

如果您的媒体资源目前配置为使用其中一个模型， 则会更改为 跨渠道以数据为依据的归因。您仍然可以选择改用“跨渠道最终点击”或“首选 Google Ads 最终点击”。

2023-09-01 添加了 SKAdNetwork 转化价值架构配置方法。

GetSKAdNetworkConversionValueSchema、 CreateSKAdNetworkConversionValueSchema、 DeleteSKAdNetworkConversionValueSchema、 UpdateSKAdNetworkConversionValueSchema、 ListSKAdNetworkConversionValueSchemas 方法已添加到 Admin API v1alpha。

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

2023-09-01 添加了 UpdateConversionEvent 方法。

UpdateConversionEvent 向 Admin API v1beta 添加了 method。

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

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

2023-07-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 字段

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

2023-06-05 弃用了“首次点击”“线性”“时间衰减”和“根据位置”归因模型。

自 2023 年 6 月起，无法使用 UpdateAttributionSettings 方法为采用 “首次点击”、 “线性”、 “时间衰减” 和 “根据位置” 归因模型的 Google Analytics 4 媒体资源进行配置。自 2023 年 9 月起，所有媒体资源都无法使用这些模型。

如需了解详情，请参阅 Google Analytics 产品公告 。

GetAdSenseLink、 CreateAdSenseLink、 DeleteAdSenseLink、 ListAdSenseLinks 方法已添加到 Admin API v1alpha。

借助此功能，您可以管理 AdSense 到 Google Analytics 的关联，适用于 GA4 媒体资源。

2023-05-31 添加了用于查找关联的 Google Analytics 4 媒体资源的方法。

向 Admin API v1alpha 添加了 FetchConnectedGa4Property 方法

借助此功能，您可以获取在 Google Analytics 4 迁移过程中与您的 Universal Analytics 媒体资源相关联的 Google Analytics 4 媒体资源 的相关信息。

2023-05-31 添加了用于管理事件创建规则的方法。

向 Admin API v1alpha 添加了 CreateEventCreateRule、 UpdateEventCreateRule、 DeleteEventCreateRule、 ListEventCreateRules、 GetEventCreateRule 方法。

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

2023-05-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 方法。

借助此功能，您可以管理 Google Analytics 4 媒体资源的网站数据流的增强型衡量设置。

2023-03-31 添加了已关联的网站代码管理方法。

向 Admin API v1alpha 添加了 properties.createConnectedSiteTag、properties.deleteConnectedSiteTag、properties.listConnectedSiteTags 方法。

借助此功能，您可以管理已关联的网站代码，这对于将流量从 Universal Analytics 媒体资源转发到 Google Analytics 4 媒体资源非常有用。

2023-03-31 向 Admin API v1beta 添加了账号级和媒体资源级 runAccessReport 方法。

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

2023-02-24 添加了展开式数据集管理方法。

向 API 的 v1alpha 版本添加了 ExpandedDataSet 资源，以及相应的 properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get 操作。此功能可用于管理 展开式数据集 在 Google Analytics 360 中。

向 API 的 v1alpha 版本添加了 AccessBinding 资源，以及以下操作：

借助此功能，您可以管理 Google Analytics 4 账号或 媒体资源的用户权限，应使用此功能而不是 用户关联。

用户关联功能将于 2023 年 6 月 1 日从 Admin API v1 alpha 中移除

2023-02-24 弃用了用户权限审核方法。

以下方法已被弃用，并将于 2023 年 6 月 1 日从 Admin API v1 alpha 中移除：

2023-02-24 添加了受众群体管理方法。

向 API 的 v1alpha 版本添加了 Audience资源，以及相应的 properties.audience.create、 properties.audience.archive、 properties.audience.patch、 properties.audience.list、 properties.audience.get 操作。

借助此功能，您可以管理 Google Analytics 4 媒体资源的 受众群体。

2023-02-15 添加了自动 Google Analytics 4 设置流程选择停用方法。

向 API 的 v1alpha 版本添加了 properties.setAutomatedGa4ConfigurationOptOut、 properties.fetchAutomatedGa4ConfigurationOptOut 操作。

借助此功能，您可以管理 Universal Analytics 媒体资源的自动 Google Analytics 4 设置流程 的选择停用状态。

向 API 的 v1alpha 版本添加了 BigQueryLink资源，以及相应的 properties.bigQueryLinks.get、 properties.bigQueryLinks.list 操作。

借助此功能，您可以检索 Google Analytics 4 媒体资源与 BigQuery 项目之间关联的相关信息。

向 API 的 v1alpha 版本添加了 SearchAds360Link 资源，以及相应的 properties.searchAds360Links.create、 properties.searchAds360Links.delete、 properties.searchAds360Links.patch、 properties.searchAds360Links.list、 properties.searchAds360Links.get 操作。

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

2023-02-15 重大更改。

2023-02-15 其他更改。

2022-08-11 向 Admin API v1alpha 添加了 runAccessReport 方法。

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

2022-07-11 发布了 Admin API v1beta 版本。

Google Analytics Admin API 的 v1beta 版本 已发布。

Admin API 的 Alpha 和 Beta 渠道将继续受到支持。Beta 渠道包含 Alpha 中提供的部分功能，这些功能被认为是稳定的，预计未来不会发生重大变化。新功能成熟后，将添加到 Beta 渠道。

2021-10-12 从 API 中移除了 EnhancedMeasurementSettings 方法。

  • properties.webDataStreams.getEnhancedMeasurementSettings、 properties.webDataStreams.updateEnhancedMeasurementSettings 方法已从 API 中移除，但增强型衡量 设置很快将再次可通过 API 修改。
  • directRoles 资源的 UserLink 字段不再支持 predefinedRoles/manage-users 角色。 应改用新的 predefinedRoles/admin 角色，该角色相当于旧的 predefinedRoles/edit 和 predefinedRoles/manage-users 角色的组合。此更改会影响 accounts.userLinks、 properties.userLinks 方法的行为，并且与 Google Analytics 中引入的 访问权限和数据限制管理 更改保持一致。

2021-06-05 添加了功能。

向 API 添加了以下功能：

2021-06-05 重大更改。

引入了以下重大更改：

  • 从 API 中移除了 properties.iosAppDataStreams.create、properties.androidAppDataStreams.create 方法。请使用 Firebase 在 Google Analytics 4 媒体资源中创建应用数据流。
  • properties.delete 方法现在会以 Property 类型返回已删除的媒体资源数据，而不是返回空响应。
  • time_zone 类型的 Property 字段现在需要。
  • 移除了 deleted 字段，从 Property 类型。
  • email_address 类型的 UserLink 字段现在不可变。
  • name 类型的 UserLink 字段现在仅限输出。

2021-01-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-08-15 将 Management 应用 + 网站 API 重命名为 Admin API。

Google Analytics Management 应用 + 网站 API 已重命名为 Google Analytics Admin API。因此，API 端点已更改为 analyticsadmin.googleapis.com。需要相应地更新针对先前版本的 API 端点网址和客户端库编写的现有代码。