开始将 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 条款的要求，请参阅此常见问题解答。

Firebase 控制台

1. 前往 Firebase 控制台。

2. 使用可让您访问现有 Google Cloud 项目的同一 Google 账号登录。

3. 点击创建项目。

4. 在页面底部，点击已有 Google Cloud 项目了？链接。

5. 在文本字段中，开始输入现有项目的项目 ID，然后从显示的列表中选择该项目。

6. 点击打开项目。

7. 如果系统提示，请接受 Firebase 条款。

8. 按照屏幕上的说明“添加 Firebase”并设置 Firebase 项目。

   请注意，启用 Google Analytics 是可选操作。

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 服务条款。您还需要接受 Firebase 条款，才能向现有 Google Cloud 项目“添加 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: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”。您可以做出如下选择：

• 使用“限制允许的 Google Cloud API 和服务”约束条件阻止启用 firebase.googleapis.com API。

• 限制拥有“添加 Firebase”所需的 IAM 权限 firebase.projects.update 的项目成员（即主账号）。您可以使用 IAM 拒绝政策高效地执行此操作。

后续步骤

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

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

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

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