更新日志

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

2024 年 9 月 9 日 访问权限报告调查问卷表单

有关 runAccessReport 方法进行了更新,添加了一个指向 Google Analytics 访问报告反馈 表单。我们非常重视您的意见,并鼓励您分享自己对此问题的想法 帮助我们进一步改进该 API。

添加了 CreateBigQueryLinkUpdateBigQueryLinkDeleteBigQueryLink 管理 Deployment 的 BigQueryLink 项资源 Admin API v1alpha 版。

BigQueryLink 资源添加了 dataset_location 字段。

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

2024 年 8 月 1 日:对 createSubproperty 方法的重大更改

createSubproperty 自定义方法重命名为 provisionSubproperty ,以与自定义方法 指南

2024 年 8 月 1 日 添加了事件修改规则管理

GetEventEditRuleCreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, Admin API v1alpha 版中新增的一些方法。

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

2024 年 8 月 1 日 其他变更

create_time 添加到了 Audience 资源。

primary 添加到了 ChannelGroup 资源 指明该渠道组是否为报告的默认渠道组。仅一个 渠道组在任何给定时间都可以将 primary 设置为 true。设置 渠道组的 primarytrue 会自动将 primary 设置为 false 之前的主要渠道组。

Account 添加了 gmp_organization 资源,其中包含 Google Marketing Platform 组织的 URI 资源。

2024 年 5 月 6 日 添加了关键事件管理方法

密钥的资源和方法 事件

修改您的 API 集成以使用 KeyEvent(原价) ConversionEventConversionEvent 已弃用。

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 添加了 GetSKAdNetworkConversionValueSchemaCreateSKAdNetworkConversionValueSchemaDeleteSKAdNetworkConversionValueSchemaUpdateSKAdNetworkConversionValueSchemaListSKAdNetworkConversionValueSchemas 方法。

此功能可用于管理 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.updateAttributionSettingsproperties.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-10AttributionSettings 类型添加了 ads_web_conversion_data_export_scope 字段

ads_web_conversion_data_export_scope 字段添加到了 AttributionSettings 类型,可使用 UpdateAttributionSettings 方法。

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

从 2023 年 6 月开始,您可以使用 UpdateAttributionSettings 方法不能用于配置 GA4 媒体资源 首次点击线性广告时间衰减根据位置 归因模型。自 2023 年 9 月起,这些模型将变为 不适用于所有媒体资源。

请参阅 Google Analytics 产品公告

GetAdSenseLinkCreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks Admin API v1alpha 版中新增的一些方法。

此功能可管理AdSense 与 Google Analytics 之间的关联

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

FetchConnectedGa4Property Admin API v1alpha 版中添加了 方法

通过此功能,您可以获取 GA4 媒体资源已关联您的 Universal Analytics 媒体资源 进行迁移。

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

CreateEventCreateRuleUpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule 方法已添加到 Admin API v1alpha 中。

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

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

添加了GetChannelGroupListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup 方法。

借助此功能 自定义渠道组 找出您网站的流量来源

创建自定义渠道组后,您可以使用 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 方法。

properties.runAccessReportaccounts.runAccessReport v1beta 版 Admin API 中新增了一些方法。方法会返回一个 自定义的数据访问记录报告

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

ExpandedDataSet v1alpha 版中的资源以及相应的 properties.expandedDataSets.createproperties.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.createproperties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get 操作。

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

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

properties.setAutomatedGa4ConfigurationOptOutv1alpha 版 API 中新增了 properties.fetchAutomatedGa4ConfigurationOptOut 操作。

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

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

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

SearchAds360Link 资源已添加到 API 的 v1alpha 版本,以及相应的 properties.searchAds360Links.createproperties.searchAds360Links.deleteproperties.searchAds360Links.patchproperties.searchAds360Links.listproperties.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.getEnhancedMeasurementSettingsproperties.webDataStreams.updateEnhancedMeasurementSettings 方法是 已从 API 中移除,但增强型衡量功能 很快即可再次通过 API 修改这些设置。
  • UserLinkdirectRoles 字段 资源不再支持 predefinedRoles/manage-users 角色。 应改用新的 predefinedRoles/admin 角色,即 相当于旧版 predefinedRoles/editpredefinedRoles/manage-users 个角色。此更改会影响 accounts.userLinksproperties.userLinks 方法,并且符合访问权限和数据限制管理 Google Analytics 中引入的新功能。

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

该 API 中新增了以下功能:

2021 年 6 月 5 日:重大变更。

引入了以下破坏性更改:

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