Method: projects.addGoogleAnalytics

將指定的 FirebaseProject 連結至現有的 Google Analytics 帳戶。

透過這項呼叫，您可以：

  • 指定 analyticsAccountId 即可在指定帳戶中佈建新的 Google Analytics 資源，並將新資源與 FirebaseProject 建立關聯。
  • 指定現有的 analyticsPropertyId，將屬性與 FirebaseProject 建立關聯。

請注意，呼叫 projects.addGoogleAnalytics 時請注意：

  1. 第一項檢查會判斷 Google Analytics 資源中是否有任何現有的資料串流對應到 FirebaseProject 中任何現有的 Firebase 應用程式 (根據與資料串流相關聯的 packageName 或 bundleId)。接著，視情況連結資料串流和應用程式。請注意，這個自動連結功能僅適用於 AndroidApps 和 IosApps。
  2. 如果 Firebase 應用程式沒有對應的資料串流，系統會在 Google Analytics 資源中為每個 Firebase 應用程式佈建新的資料串流。請注意，系統一律會為網頁應用程式佈建新的資料串流，即使先前已與 Analytics 資源中的資料串流建立關聯也一樣。

請參閱 Analytics 說明文件，進一步瞭解 Google Analytics 帳戶的階層和結構。

此呼叫的結果為 Operation。輪詢Operation以追蹤佈建程序，方法是呼叫 operations.get，直到 done true。當 done 為 true 時，Operation 是成功或失敗。如果 Operation 成功，其 response 會設定為 AnalyticsDetails；如果 Operation 失敗，則其 error 會設定為 google.rpc.Status。

如要呼叫 projects.addGoogleAnalytics，專案成員必須是現有FirebaseProject的擁有者，並擁有 Google Analytics 帳戶的 Edit 權限。

如果 FirebaseProject 已啟用 Google Analytics，而您呼叫 projects.addGoogleAnalytics 時使用的 analyticsPropertyId 與目前相關聯的資源不同，則呼叫會失敗。Firebase 控制台可能已啟用 Analytics，也可以在呼叫 projects.addFirebase 中指定 timeZone 和 regionCode。

HTTP 要求

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

這個網址使用 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

詳情請參閱驗證總覽一文。