将指定的FirebaseProject
与现有的Google Analytics 帐户链接。
使用此调用,您可以:
- 指定
analyticsAccountId
以在指定帐户内配置新的 Google Analytics 属性,并将新属性与FirebaseProject
关联。 - 指定现有的
analyticsPropertyId
以将该属性与FirebaseProject
关联。
请注意,当您调用projects.addGoogleAnalytics
时:
- 第一个检查确定 Google Analytics 属性中的任何现有数据流是否与
FirebaseProject
中的任何现有 Firebase 应用相对应(基于与数据流关联的packageName
或bundleId
)。然后,在适用的情况下,链接数据流和应用程序。请注意,此自动链接仅适用于AndroidApps
和IosApps
。 - 如果没有找到 Firebase 应用的相应数据流,则会在 Google Analytics 属性中为每个 Firebase 应用配置新的数据流。请注意,始终会为 Web 应用程序配置新的数据流,即使它之前与 Analytics 属性中的数据流关联也是如此。
在Google Analytics(分析)文档中详细了解 Google Analytics(分析)帐户的层次结构和结构。
此调用的结果是一个Operation
。通过调用operations.get
轮询Operation
以跟踪配置过程,直到done
为true
。当done
为true
时, Operation
要么成功,要么失败。如果Operation
成功,其response
将设置为AnalyticsDetails
;如果Operation
失败,其error
将设置为google.rpc.Status
。
要调用projects.addGoogleAnalytics
,项目成员必须是现有FirebaseProject
的所有者,并且拥有Google Analytics帐户的Edit
权限。
如果FirebaseProject
已启用 Google Analytics,并且您使用与当前关联属性不同的analyticsPropertyId
调用projects.addGoogleAnalytics
,则调用将会失败。分析可能已在 Firebase 控制台中启用,或者通过在调用projects.addFirebase
中指定timeZone
和regionCode
来启用。
HTTP请求
POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics
URL 使用gRPC 转码语法。
路径参数
参数 | |
---|---|
parent | 要链接到现有 Google Analytics 帐户的 有关PROJECT_IDENTIFIER值的详细信息,请参阅 |
请求正文
请求正文包含具有以下结构的数据:
JSON 表示 |
---|
{ // Union field |
领域 | |
---|---|
联合字段analytics_resource 。请求正文中只能指定一种 Google Analytics 资源。
analytics_resource 只能是以下之一: | |
analyticsAccountId | 您想要与 指定此字段将在您的 Google Analytics 帐户中配置新的 Google Analytics 属性,并将新属性与 |
analyticsPropertyId | 您想要与 |
响应体
如果成功,响应正文将包含一个Operation
实例。
授权范围
需要以下 OAuth 范围之一:
-
https://www.googleapis.com/auth/cloud-platform
-
https://www.googleapis.com/auth/firebase
有关详细信息,请参阅身份验证概述。