介绍
npm 包 juttle-gmail-adapter 是一个基于 Juttle 的 Gmail 数据源适配器。它允许用户通过 Juttle 语言查询他们的 Gmail 邮件数据。该适配器可以与 juttle-service 一起使用,以将 Juttle 程序转换为可执行的查询,并输出结果。
安装
在你的项目中使用以下命令安装 juttle-gmail-adapter:
npm install juttle-gmail-adapter
配置
使用 juttle-gmail-adapter 前,需要首先在 Google Cloud 管理控制台创建一个 OAuth 2.0 客户端 ID,并将其用于身份验证。因为 Gmail 令牌的获取必须通过 OAuth 2.0,所以需要提供以下详细信息:
client_id
- OAuth 2.0 客户端 ID,由 Google Cloud 管理控制台提供。client_secret
- OAuth 2.0 客户端密钥,由 Google Cloud 管理控制台提供。access_token
- 从 Google 身份验证服务器获取的访问令牌。refresh_token
- 用于刷新访问令牌的 OAuth 2.0 刷新令牌。
配置方式有两种:
配置文件
在使用时,可以通过创建 juttle-config.js
文件来配置 juttle-gmail-adapter。例如:
module.exports = { gmail: { client_id: 'your_client_id', client_secret: 'your_client_secret', access_token: 'your_access_token', refresh_token: 'your_refresh_token' } };
环境变量
你也可以通过在环境变量中设置相应的键值对来配置 juttle-gmail-adapter。例如:
export JUTTLE_GMAIL_ADAPTER_CLIENT_ID=your_client_id export JUTTLE_GMAIL_ADAPTER_CLIENT_SECRET=your_client_secret export JUTTLE_GMAIL_ADAPTER_ACCESS_TOKEN=your_access_token export JUTTLE_GMAIL_ADAPTER_REFRESH_TOKEN=your_refresh_token
使用
下面是一个简单的 Juttle 查询示例,用于查找某个用户的最新电子邮件:
read gmail -subject 'important' -to 'someuser@somedomain.com' -limit 1 -since '2018-01-01'
可以使用以下参数进行过滤,支持链式调用:
-subject
:电子邮件主题。-from
:发件人的电子邮件地址。-to
:收件人的电子邮件地址。-label
:邮件标签名称。-before
:在此日期之前发送的电子邮件。-after
:在此日期之后发送的电子邮件。-since
:在此日期及之后发送的电子邮件。
除此之外,还可以使用以下参数:
-attachment
:包含在电子邮件中的附件。-search
:基于主题或邮件正文内容查找电子邮件。-limit
:返回查询结果的条目数。-sort
:按日期或主题对查询结果进行排序。
总结
npm 包 juttle-gmail-adapter 是一个很好用的 Gmail 数据源适配器,它可以方便地将 Gmail 邮件数据集成到你的 Juttle 应用中。本文介绍了如何安装和配置 juttle-gmail-adapter,以及如何进行基本的数据查询。希望本文能够对你有所帮助!
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066ef94c49986ca68d8781