使用現有的 Google Cloud 專案開始使用 Firebase

Firebase 專案是Google Cloud專案，其中啟用了一些額外的 Firebase 專屬設定和服務。這通常稱為「將 Firebase 新增至Google Cloud專案」。本頁說明如何「新增 Firebase」，並提供一些常見問題的解答。

在Google Cloud專案中新增 Firebase 時，系統會自動啟用多個 API，並建立服務帳戶，方便您使用所有 Firebase 服務和介面。Firebase 也會在 Google Cloud 控制台的「標籤」頁面中，為專案新增 firebase:enabled 標籤。進一步瞭解「新增 Firebase」的影響。

Firebase 專案與 Google Cloud 專案之間的關係

由於 Firebase 專案是 Google Cloud 專案：

• 您可以在 Firebase 控制台、Google Cloud 控制台和 Google API 控制台中存取及操作專案。

• 您可以使用 Firebase CLI、gcloud CLI，以及 Google 的任何 Terraform 資源與專案互動。

• 您可以在專案中使用 Firebase 和 Google Cloud 的產品和 API。

• 專案的 IAM 權限和角色會在 Firebase 和 Google Cloud 之間共用。專案成員 (即主體) 對 Google Cloud 專案的任何存取權，也會套用至 Firebase 專案 (反之亦然)。

• 專案的帳單會同時計入 Firebase 和 Google Cloud。如果 Google Cloud 專案已啟用計費功能，Firebase 專案就會採用 Firebase 的即付即用 Blaze 定價方案。

• 專案的專屬 ID (例如專案編號和專案 ID) 會在 Firebase 和 Google Cloud 之間共用。

• 套用至 Google Cloud 專案的任何資源階層 (例如機構、資料夾等)，也會套用至 Firebase 專案。

• 刪除專案會一併從 Firebase 和 Google Cloud 刪除。

• 如果刪除或修改專案中的資源或資料，Firebase 和 Google Cloud 中的資源或資料也會隨之變更。

如何將 Firebase 新增至現有的 Google Cloud 專案

你可以使用下列任一選項，將 Firebase「新增」至現有的 Google Cloud 專案。請確認您具備將 Firebase 新增至 Google Cloud 專案的必要權限。

請注意，一旦將 Firebase「新增至」現有 Google Cloud 專案，就無法復原 (也就是說，您無法「完全」從 Google Cloud 專案「移除」Firebase)。詳情請參閱這篇常見問題。

注意： 如要在專案中存取及使用所有 Firebase 功能，請接受 Firebase 服務條款。Google Cloud如要進一步瞭解 Firebase 條款的規定，請參閱這篇常見問題。

Firebase 控制台

1. 使用可存取現有 Google Cloud 專案的帳戶登入 Firebase 控制台。

2. 按一下按鈕，建立新的 Firebase 專案。

3. 在頁面底部點選「將 Firebase 新增到 Google Cloud 專案」。

4. 在文字欄位中，開始輸入現有專案的專案名稱，然後從顯示的清單中選取專案。

5. 按一下「開啟專案」。

6. 如果系統顯示提示，請接受 Firebase 條款。

7. 按照畫面上的指示「新增 Firebase」，並設定 Firebase 專案。

   請注意，在 Firebase 控制台和 Google Analytics 中啟用 AI 輔助功能都是選用操作。

Firebase CLI

1. 如果尚未安裝，請安裝 Firebase CLI。

2. 登入可存取現有 Google Cloud 專案的 Google 帳戶。

3. 執行下列指令：

   firebase projects:addfirebase

4. 收到提示時，從顯示的清單中選取現有 Google Cloud 專案。

注意： 如果嘗試將 Firebase「新增」至現有 Google Cloud 專案時發生 403 PERMISSION_DENIED 錯誤，可能表示您沒有必要權限，或尚未接受 Firebase 服務條款。

REST API

1. 在現有的 Google Cloud 專案中啟用 Firebase Management API。

2. 產生 API 存取權杖。

3. 呼叫 projects.addFirebase，為專案啟用 Firebase 服務。

   請注意，您需要專案的資源名稱才能進行這項呼叫。

如需詳細操作說明，請參閱 Firebase 指南「使用 Management REST API 設定及管理 Firebase 專案」中的「將 Firebase 服務新增至專案」。請務必按照該指南「事前準備」一節中的所有說明操作。

注意： 如果嘗試將 Firebase「新增至現有 Google Cloud 專案」時發生 403 PERMISSION_DENIED 錯誤，可能是因為您沒有必要權限，或是尚未接受 Firebase 服務條款。

Terraform

1. 在現有 Google Cloud 專案中啟用 Firebase Management API (firebase.googleapis.com)。

2. 使用 google_firebase_project 資源為專案啟用 Firebase 服務。

如要進一步瞭解如何使用 Firebase 和 Terraform，請參閱「開始使用 Terraform 和 Firebase」。

注意： 如果嘗試將「Firebase 新增至現有 Google Cloud 專案」時發生 403 PERMISSION_DENIED 錯誤，可能是因為您沒有必要權限，或是尚未接受 Firebase 服務條款。

常見問題與疑難排解

開始使用 Firebase 時，是否必須接受 Firebase 服務條款？

如要存取及使用 Google Cloud 專案中的所有 Firebase 功能，請接受 Firebase 服務條款。如要將 Firebase「新增」至現有的 Google Cloud 專案，您也必須接受 Firebase 條款。

只要使用 Google 帳戶接受一次 Firebase 條款即可，無論您存取多少專案都適用。接受條款時，您只會為自己的 Google 帳戶接受條款，不會為所有專案成員接受專案層級的條款。

您可以透過 Firebase 控制台，使用下列任一選項接受 Firebase 條款。當系統顯示提示時，請接受條款。

• 使用 Firebase 控制台建立新的 Firebase 專案。

• 在 Firebase 控制台中開啟現有的 Firebase 專案 (例如，有人邀請您成為專案成員，也就是專案中的主體)。

• 在 Firebase 控制台中開啟現有的 Google Cloud，然後「新增 Firebase」。

注意： 您無法使用 Firebase CLI、REST API 或 Terraform 接受 Firebase 條款。只能透過 Firebase 控制台進行。

重要事項： 如果您為了使用特定 Firebase 服務，已先透過同一個 Google Cloud Platform 帳戶簽署 Google Cloud 主協議的離線版本，則 Firebase 條款不適用於您對這類 Firebase 服務的使用行為，且您的 Firebase 服務使用行為將受到離線條款的規範。

「新增 Firebase」需要哪些權限？

如要為現有 Google Cloud 專案「新增 Firebase」，專案成員 (即主體) 必須具備下列 IAM 權限：

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

根據預設，編輯者和擁有者 IAM 角色都具備這些權限。

新增 firebase:enabled 標籤是否就等於新增 Firebase？

所有 Firebase 專案在 Google Cloud 控制台的「標籤」頁面中，都會顯示 firebase:enabled 標籤。

不過，如果只是手動將 firebase:enabled 標籤新增至專案標籤清單，Google Cloud 專案並不會啟用 Firebase 專屬設定和服務。如要這麼做，請使用 Firebase 控制台新增 Firebase (或針對進階用途，使用 Firebase CLI、Firebase Management REST API 或 Terraform)。

將 Firebase「新增」至現有 Google Cloud 專案時會發生什麼情況？

Firebase 專案是Google Cloud專案，其中啟用了一些額外的 Firebase 專屬設定和服務。因此，當您將 Firebase「新增」至現有 Google Cloud 專案時，Firebase 會採取下列動作，簡化所有 Firebase 服務和介面的使用方式：

• 在 Google Cloud 控制台的「Labels」頁面中新增firebase:enabled標籤。

• 建立「瀏覽器」API 金鑰，並自動限制只能用於 Firebase 相關 API。

• 建立下列服務帳戶：

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• 啟用下列 API：

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Firebase Dynamic Links API
  • Firebase Hosting API
  • Firebase Installations API
  • Firebase Management API
  • Firebase 遠端設定 API
  • Firebase 遠端設定即時 API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

我可以從專案「移除 Firebase」嗎？

將 Firebase「新增」至現有 Google Cloud 專案後，就無法復原 (也就是說，您無法從 Google Cloud 專案「完全」移除 Firebase)。

「新增 Firebase」的程序會啟用可用於其他Google Cloud功能的 API 和後端服務。停用所有已啟用的服務可能會因依附元件而導致非預期的後果。

不過，您可以選擇手動停用所有 API，並刪除「新增 Firebase」時自動啟用及建立的標籤、API 金鑰和服務帳戶。

警告： 如果選擇手動停用及刪除「新增 Firebase」期間發生的情況，請務必謹慎操作。請務必確認您的 Google Cloud 專案和與專案相關聯的應用程式未使用任何與您要停用及刪除項目相關的內容，否則專案或應用程式可能會停止運作或出現異常行為。

我可以禁止為現有 Google Cloud 專案「新增 Firebase」嗎？

雖然您無法實際封鎖「將 Firebase 新增至現有 Google Cloud 專案」的可能性，但可以採取下列做法：

限制擁有 IAM 權限 firebase.projects.update 的專案成員 (即主體)，這是「新增 Firebase」的必要權限。

後續步驟

• 如要進一步瞭解 Firebase 專案，請參閱下列資源：

  • 瞭解 Firebase 專案：簡要介紹 Firebase 專案的幾個重要概念，包括與 Google Cloud 的關係，以及專案、應用程式和資源的基本階層。

  • 設定 Firebase 專案的一般最佳做法：提供設定 Firebase 專案的一般高階最佳做法，以及向專案註冊應用程式，讓您清楚瞭解使用不同環境的開發工作流程。

• 如要在行動和網頁應用程式中使用 Firebase，請向 Firebase 專案註冊應用程式，並將應用程式連結至 Firebase：iOS+ | Android | 網頁 | Flutter | Unity | C++。