Method: projects.addGoogleAnalytics

将指定的FirebaseProject与现有的Google Analytics 帐户链接。

使用此调用,您可以:

  • 指定analyticsAccountId以在指定帐户内配置新的 Google Analytics 属性,并将新属性与FirebaseProject关联。
  • 指定现有的analyticsPropertyId以将该属性与FirebaseProject关联。

请注意,当您调用projects.addGoogleAnalytics时:

  1. 第一个检查确定 Google Analytics 属性中的任何现有数据流是否与FirebaseProject中的任何现有 Firebase 应用相对应(基于与数据流关联的packageNamebundleId )。然后,在适用的情况下,链接数据流和应用程序。请注意,此自动链接仅适用于AndroidAppsIosApps
  2. 如果没有找到 Firebase 应用的相应数据流,则会在 Google Analytics 属性中为每个 Firebase 应用配置新的数据流。请注意,始终会为 Web 应用程序配置新的数据流,即使它之前与 Analytics 属性中的数据流关联也是如此。

Google Analytics(分析)文档中详细了解 Google Analytics(分析)帐户的层次结构和结构。

此调用的结果是一个Operation 。通过调用operations.get轮询Operation以跟踪配置过程,直到donetrue 。当donetrue时, Operation要么成功,要么失败。如果Operation成功,其response将设置为AnalyticsDetails ;如果Operation失败,其error将设置为google.rpc.Status

要调用projects.addGoogleAnalytics ,项目成员必须是现有FirebaseProject的所有者,并且拥有Google Analytics帐户的Edit权限

如果FirebaseProject已启用 Google Analytics,并且您使用与当前关联属性不同的analyticsPropertyId调用projects.addGoogleAnalytics ,则调用将会失败。分析可能已在 Firebase 控制台中启用,或者通过在调用projects.addFirebase中指定timeZoneregionCode来启用。

HTTP请求

POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics

URL 使用gRPC 转码语法。

路径参数

参数
parent

string

要链接到现有 Google Analytics 帐户的FirebaseProject资源名称,格式为:

projects/ PROJECT_IDENTIFIER

有关PROJECT_IDENTIFIER值的详细信息,请参阅FirebaseProject name字段。

请求正文

请求正文包含具有以下结构的数据:

JSON 表示
{

  // Union field analytics_resource can be only one of the following:
  "analyticsAccountId": string,
  "analyticsPropertyId": string
  // End of list of possible types for union field analytics_resource.
}
领域
联合字段analytics_resource

请求正文中只能指定一种 Google Analytics 资源。
  • 要配置新的 Google Analytics 属性并将其与FirebaseProject关联,请提供analyticsAccountId
  • 要将现有 Google Analytics 属性与FirebaseProject关联,请提供analyticsPropertyId


analytics_resource只能是以下之一:
analyticsAccountId

string

您想要与FirebaseProject关联的现有Google Analytics 帐户的 ID。

指定此字段将在您的 Google Analytics 帐户中配置新的 Google Analytics 属性,并将新属性与FirebaseProject相关联。

analyticsPropertyId

string

您想要与FirebaseProject关联的现有 Google Analytics 属性的 ID。

响应体

如果成功,响应正文将包含一个Operation实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

有关详细信息,请参阅身份验证概述