更新日志

有关 Google Analytics API 的官方公告，请订阅 Google Analytics API 通知群组。

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

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas Admin API v1alpha 版中新增的一些方法。

此功能可用于管理 SKAdNetwork 转化价值架构 配置 。

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

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 产品公告 。

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 中管理展开式数据集。

AccessBinding v1alpha 版 API，以及 以下操作：

此功能可用于管理 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 媒体资源。

BigQueryLink v1alpha 版 API，以及 相应的 properties.bigQueryLinks.get， properties.bigQueryLinks.list 操作。

借助此功能，您可以检索 GA4 媒体资源与 BigQuery 项目之间的关联。

SearchAds360Link v1alpha 版中的资源以及相应的 properties.searchAds360Links.create， properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get 操作。

借助此功能，您可以管理 GA4 媒体资源与 Search Ads 360 实体。

2023 年 2 月 15 日：重大变更。

2023 年 2 月 15 日 其他变更。

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

properties.runAccessReport 方法已添加到 v1alpha 版 Admin API 中。它会返回一个 数据访问记录的自定义报告。该报告会提供 当用户读取 Google Analytics 报告数据时触发。数据访问权限报告 。

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

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 中新增了以下功能：

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 的 type 现在不可变。
  • name UserLink 的 类型现在只是输出。

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 端点网址和客户端库进行相应更新。