Google 致力于为黑人社区推动种族平等。查看具体举措

触发电子邮件

Firebase
Made by Firebase

根据写入指定 Cloud Firestore 集合的文档内容撰写和发送电子邮件。

此扩展程序的运作方式

使用此扩展程序可以呈现和发送含有已添加到指定 Cloud Firestore 集合的文档中的信息的电子邮件。

添加文档会触发此扩展程序,以发送通过文档字段构建的电子邮件。文档中的顶级字段会指定电子邮件的发件人和收件人,包括“to”、“cc”和“bcc”选项(均支持 UID)。文档的“message”字段指定其他电子邮件元素,例如主题行和电子邮件正文(纯文本或 HTML)

这是触发此扩展程序的一个基本示例文档:

admin.firestore().collection('mail').add({
  to: 'someone@example.com',
  message: {
    subject: 'Hello from Firebase!',
    html: 'This is an <code>HTML</code> email body.',
  },
})

您还可以选择将此扩展程序配置为使用 Handlebar 模板呈现电子邮件。每个模板都是一个存储在 Cloud Firestore 集合中的文档。

配置此扩展程序时,您需要提供 邮件递送所需的 SMTP 凭据 。请注意,此扩展程序需要搭配使用群发电子邮件服务,例如 SendGrid、Mailgun 等。

额外设置

在安装此扩展程序之前,请确保您已经在 Firebase 项目中 设置了一个 Cloud Firestore 数据库

结算

若要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案

  • 您需要为此扩展程序所需的 Firebase 资源支付少量费用(通常约为 $0.01/月),即使没有使用此扩展程序也要支付。
  • 此扩展程序用到了其他 Firebase 和 Google Cloud Platform 服务,如果超出这些服务的免费层级,则会产生相关费用:
  • Cloud Firestore
  • Cloud Functions(Node.js 10+ 运行时。 查看常见问题解答 )

使用此扩展程序时,您还需要具有用于投递邮件的 SMTP 凭据。您需要自行承担与使用 SMTP 提供商服务相关的任何费用。

如何安装此扩展程序

使用 Firebase 控制台

要安装和管理扩展程序,您可以使用 Firebase 控制台。

使用控制台安装

使用 Firebase CLI

要安装和管理扩展程序,您还可以使用 Firebase CLI:

步骤 1 :运行以下 npm 命令来安装 CLI 或将 CLI 更新到最新版本。

npm install -g firebase-tools
不能运行?请参阅 Firebase CLI 参考文档 或者更改您的 npm 权限

第 2 步 设置一个新的 Firebase 项目目录 或转到现有目录

第 3 步 :将此扩展程序添加到 扩展程序清单

firebase ext:install firebase/firestore-send-email --local --project=projectId_or_alias

Step 4 (Optional): Test this extension locally with the Firebase Emulator Suite

firebase emulators:start

第 5 步 :将清单中的扩展程序 部署 到项目中

firebase deploy --only extensions --project=projectId_or_alias
支持
Cloud Firestore
作者
许可
Apache-2.0
版本
0.1.19