Google Analytics（分析）Admin API 概览

摘要：此文档简要介绍 Google Analytics Admin API 1.0 版。

此 API 以 Alpha 和 Beta 渠道提供功能。Alpha 版和 Beta 版产品获得的支持可能较为有限，而且对这些产品的更改可能不兼容其他 Alpha 版和 Beta 版。

Alpha 版： 功能尚处于早期预览版阶段。我们会尽量通知您 预计在 API 公开发布之前会发生破坏性更改。

Beta 版： 此渠道预计不会发生重大更改。

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

简介

通过 Google Analytics Admin API，您可以通过编程方式访问 Google Analytics 4 (GA4) 配置数据，并且仅与 GA4 媒体资源兼容。详细了解 GA4 媒体资源。

您可以使用 Google Analytics Admin API 执行以下操作：

• 配置新账号。
• 管理账号。
• 管理数据共享设置。
• 列出账号摘要。
• 搜索更改历史记录事件。
• 管理媒体资源。
• 管理子媒体资源。
• 确认用户数据收集。
• 管理媒体资源的数据保留设置。
• 管理媒体资源的 Google 信号设置（Alpha 版）。
• 管理直播。
• 管理 Measurement Protocol 密钥。
• 管理 SKAdNetwork 转化价值架构（Alpha 版）。
• 为网站数据流生成 Google 代码段（Alpha 版）。
• 管理关键事件。
• 管理转化事件（已弃用）。
• 管理事件创建规则（Alpha 版）
• 管理事件修改规则（Alpha 版）
• 管理自定义维度。
• 管理自定义指标。
• 管理 GA4 媒体资源与 Firebase 项目之间的关联。
• 管理 GA4 媒体资源与 Google Ads 账号之间的关联。
• 管理有关关联 GA4 媒体资源与展示广告系列的提案视频 360 广告客户（Alpha 版）。
• 管理 GA4 媒体资源与展示广告系列之间的关联Video 360 广告客户 （Alpha 版）。
• 管理 GA4 媒体资源与 Search Ads 360（Alpha 版）之间的关联。
• 管理 GA4 媒体资源与 BigQuery 项目（Alpha 版）之间的关联。
• 管理账号层次结构和 GA4 媒体资源的用户权限 （Alpha 版）。
• 生成数据访问报告。
• 管理受众群体（Alpha 版）。
• 管理展开式数据集（Alpha 版）。
• 管理 GA4 自动设置流程停用设置（Alpha 版）。

可用的方法

以下是可用的方法。

账号配置

• accounts.provisionAccountTicket

此方法返回应包含在 accountTicketId 中的 服务条款 (TOS) 网址： https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID。 如果用户访问 TOS 网址并接受服务条款，则系统将创建一个 至此，Google Analytics 账号将会创建完毕。请参阅账号配置 示例。

账号管理

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

数据共享设置管理

• accounts.getDataSharingSettings

列出账号摘要

• accountSummaries.list

搜索更改历史记录事件

• accounts.searchChangeHistoryEvents

房源管理

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

子媒体资源管理（Alpha 版）

• properties.provisionSubproperty

用户数据收集确认书

• properties.acknowledgeUserDataCollection

数据保留设置管理

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Google 信号设置管理（Alpha 版）

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

数据流管理

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

Measurement Protocol 密钥管理

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

SKAdNetwork 转化价值架构管理（Alpha 版）

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

关键事件管理

• properties.keyEvents.create
• properties.keyEvents.get
• properties.keyEvents.list
• properties.keyEvents.delete
• properties.keyEvents.patch

转化事件管理

已废弃： 使用 KeyEvent 资源和方法 。

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.patch

活动创建规则管理（Alpha 版）

• properties.eventCreateRules.create
• properties.eventCreateRules.get
• properties.eventCreateRules.list
• properties.eventCreateRules.delete
• properties.eventCreateRules.patch

事件修改规则管理（Alpha 版）

• properties.eventEditRules.create
• properties.eventEditRules.get
• properties.eventEditRules.list
• properties.eventEditRules.delete
• properties.eventEditRules.patch

自定义维度管理

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

自定义指标管理

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Firebase 项目关联

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Google Ads 账号关联

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Google 代码生成（Alpha 版）

• properties.webDataStreams.getGlobalSiteTag

关于如何在 GA4 媒体资源与展示广告系列之间建立关联的建议Video 360 广告客户（Alpha 版）

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

展示广告与Video 360 广告客户账号关联（Alpha 版）

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Search Ads 360 账号关联（Alpha 版）

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

详细了解如何设置 Google Analytics Search Ads 360 集成（适用于 GA4） 属性。

BigQuery 账号关联（Alpha 版）

• properties.bigQueryLinks.create
• properties.bigQueryLinks.delete
• properties.bigQueryLinks.get
• properties.bigQueryLinks.list
• properties.bigQueryLinks.patch

详细了解如何设置 BigQuery Export 。

用户权限管理（Alpha 版）

• 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

数据访问权限报告

• properties.runAccessReport

有关详情，请参阅数据访问权限报告指南 功能。

受众群体管理（Alpha 版）

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

详细了解受众群体 。

展开式数据集管理（Alpha 版）

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

详细了解展开式数据集 。

选择停用 GA4 自动设置流程（Alpha 版）

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

详细了解如何管理停用 状态 了解 UA 媒体资源的自动 GA4 设置流程。