开始将 Firebase 与现有 Google Cloud 项目搭配使用

Firebase 项目是一个启用了一些额外 Firebase 特定配置和服务的 Google Cloud 项目。这通常称为向 Google Cloud 项目“添加 Firebase”。本页面介绍如何“添加 Firebase”以及一些常见问题解答 (FAQ)。

向 Google Cloud 项目添加 Firebase 后，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）会在 Firebase 和 Google Cloud 之间共享。

• 任何应用于 Google Cloud 项目的资源层次结构（例如组织、文件夹等）也将应用于 Firebase 项目。

• 删除项目会将其从 Firebase 和 Google Cloud 中删除。

• 删除或修改项目中的资源或数据会影响到 Firebase 和 Google Cloud。

如何向现有 Google Cloud 项目添加 Firebase

您可以使用以下任一选项向现有 Google Cloud 项目“添加 Firebase”。确保您拥有向 Google Cloud 项目添加 Firebase 所需的权限。

请注意，向现有 Google Cloud 项目“添加 Firebase”后，您将无法撤消此操作（也就是说，您无法完全从 Google Cloud 项目中“移除 Firebase”）。如需了解详情，请参阅此常见问题解答。

注意：如需在 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 项目。

注意：如果您在尝试向现有 Google Cloud 项目“添加 Firebase”时收到 403 PERMISSION_DENIED 错误，可能是因为您没有所需权限或尚未接受 Firebase 服务条款。

REST API

1. 在现有 Google Cloud 项目中启用 Firebase Management API。

2. 生成 API 访问令牌。

3. 通过调用 projects.addFirebase 为项目启用 Firebase 服务。

   请注意，您需要项目的资源名称才能进行此调用。

如需详细说明，请参阅 Firebase 指南中的将 Firebase 服务添加到您的项目中：“使用 Management REST API 设置和管理 Firebase 项目”。请务必按照该指南的准备工作部分中的所有说明操作。

注意：如果您在尝试向现有 Google Cloud 项目“添加 Firebase”时收到 403 PERMISSION_DENIED 错误，可能是因为您没有所需权限或尚未接受 Firebase 服务条款。

Terraform

1. 在现有 Google Cloud 项目中启用 Firebase Management API (firebase.googleapis.com)。

2. 使用 google_firebase_project 资源为项目启用 Firebase 服务。

如需详细了解如何使用 Firebase 和 Terraform，请参阅使用入门：将 Terraform 与 Firebase 搭配使用。

注意：如果您在尝试向现有 Google Cloud 项目“添加 Firebase”时收到 403 PERMISSION_DENIED 错误，可能是因为您没有所需权限或尚未接受 Firebase 服务条款。

常见问题解答和问题排查

是否必须接受 Firebase 服务条款才能开始使用 Firebase？

如需在 Google Cloud 项目中访问和使用 Firebase 的所有功能，您需要接受 Firebase 服务条款。 如需向现有 Google Cloud 项目“添加 Firebase”，您也需要接受 Firebase 条款。

无论您有权访问多少个项目，只需针对您的 Google 账号接受一次 Firebase 条款。您接受条款时，仅代表您接受这些条款适用于您的 Google 账号；不代表所有项目成员在项目级接受这些条款。

您可以在 Firebase 控制台中使用以下任一选项接受 Firebase 条款。出现提示时，接受条款。

• 使用 Firebase 控制台创建新的 Firebase 项目。

• 在 Firebase 控制台中打开现有的 Firebase 项目（例如，有人邀请您成为项目成员，即主账号）。

• 在 Firebase 控制台中打开现有的 Google Cloud 项目，并向该项目添加 Firebase。

注意：您无法使用 Firebase CLI、REST API 或 Terraform 接受 Firebase 条款。只能使用 Firebase 控制台执行此操作。

重要提示：如果您就通过同一个 Google Cloud Platform 账号使用指定 Firebase 服务签署了 Google Cloud 主协议的线下版本，则 Firebase 条款不适用于您对此类 Firebase 服务的使用，您在使用此类 Firebase 服务时应遵守您所签署的线下条款。

需要哪些权限才能“添加 Firebase”？

如需向现有 Google Cloud 项目“添加 Firebase”，项目成员（即主账号）必须拥有以下 IAM 权限：

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

默认情况下，IAM 角色“Editor”和“Owner”包含这些权限。

为什么 Firebase 控制台无法加载我的现有 Google Cloud 项目列表？

如果您尝试使用 Firebase 控制台向现有 Google Cloud 项目“添加 Firebase”，并且拥有数千个 Google Cloud 项目的访问权限，则此常见问题解答通常适用。

Firebase 控制台的设计并未考虑加载数千个 Google Cloud 项目。建议您使用 Firebase CLI、REST API 或 Terraform 向现有 Google Cloud 项目“添加 Firebase”。

此外，您或许可以查阅另一条常见问题解答“为什么我的 Firebase 项目未显示在 Firebase 项目列表中？”

添加 firebase:enabled 标签是否足以添加 Firebase？

所有 Firebase 项目在 Google Cloud 控制台的“标签”页面中都有一个 firebase:enabled 标签。

不过，仅将 firebase:enabled 标签手动添加到项目标签列表中并不会为您的 Google Cloud 项目启用特定于 Firebase 的配置和服务。要做到这一点，您需要使用 Firebase 控制台添加 Firebase（或者，对于高级用例，您需要使用 Firebase CLI、Firebase Management REST API 或 Terraform）。

向现有 Google Cloud 项目“添加 Firebase”后会发生什么情况？

Firebase 项目是一个启用了一些额外 Firebase 特定配置和服务的 Google Cloud 项目。因此，当您向现有 Google Cloud 项目“添加 Firebase”后，Firebase 会执行以下操作，以简化所有 Firebase 服务和接口的使用：

• 在 Google Cloud 控制台的“标签”页面中添加 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 Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

是否可以从项目中“移除 Firebase”？

向现有 Google Cloud 项目“添加 Firebase”后，您将无法撤消此操作（也就是说，您无法完全从 Google Cloud 项目中“移除 Firebase”）。

“添加 Firebase”过程会启用可用于其他 Google Cloud 功能的 API 和后端服务。停用所有这些已启用的服务可能会因依赖关系而导致意外后果。

不过，如果您愿意，可以手动停用所有 API，并删除在“添加 Firebase”时自动启用和创建的标签、API 密钥和服务账号。

警告：如果您选择手动停用并删除“添加 Firebase”期间发生的操作，请务必格外小心。您需要绝对确定您的 Google Cloud 项目以及与该项目关联的应用不会使用与您要停用和删除的对象相关的任何内容；否则，您的项目或应用可能会停止运行或出现意外行为。

是否可以针对现有 Google Cloud 项目阻止“添加 Firebase”操作？

虽然您实际上无法阻止向现有 Google Cloud 项目“添加 Firebase”，但您可以执行以下操作：

限制拥有“添加 Firebase”所需的 IAM 权限 firebase.projects.update 的项目成员（即主账号）。

后续步骤

• 如需详细了解 Firebase 项目，请查看以下资源：

  • 了解 Firebase 项目 - 简要介绍 Firebase 项目的一些重要概念，包括它们与 Google Cloud 的关系以及项目及其应用和资源的基本层次结构。

  • 设置 Firebase 项目的常规最佳实践 - 提供了有关设置 Firebase 项目以及在项目中注册应用的概括性常规最佳实践，以便设置使用不同环境并且清晰明确的开发工作流。

• 如需开始在移动应用和 Web 应用中使用 Firebase，请将应用注册到 Firebase 项目并将其连接到 Firebase：iOS+ | Android | Web | Flutter | Unity | C++。