gmail api
本文由Simon Codrington同行评审。 感谢所有SitePoint的同行评审员使SitePoint内容达到最佳状态!
在上一篇文章中 ,我演示了如何使用Gmail JavaScript API构建基本的Gmail收件箱和邮件查看应用程序。 今天,我将使用Gmail强大的后端通过电子邮件发送功能来增强该应用程序。 最后,我们将提供一个可定制的应用程序,该应用程序可以显示最近的消息,允许撰写新消息,并允许我们回复特定的消息。
不必阅读上一篇文章,也可以阅读本文(尽管它将使您对主题有更深入的了解)。 与以往一样,可以在我们的GitHub存储库 (位于文件夹02 - Sending mail
)中找到本文的完整源代码。
在您的Google帐户上启用Gmail API
第一步是在您的Google帐户上设置Gmail API。 这将使我们能够创建利用Gmail功能的应用程序。 自从我们上次查看Gmail API以来,Google已经更改了API管理控制台的用户界面-因此,这里是有关如何创建必要的Gmail API凭据的快速更新。
导航到Google Developer Console并创建一个项目。 单击创建将带我们进入新的项目仪表板界面。 在这里,我们需要弹出汉堡导航菜单并选择API Manager ,然后在左侧的边栏中,我们需要选择Credentials ,然后单击下一页上的New certificate按钮。
现在,我们需要创建两组凭证:浏览器API密钥和OAuth客户端ID。
对于浏览器API密钥,请选择API密钥,然后选择浏览器密钥 。 在接下来的页面上,我们只需要填写名称字段。 但是,对于生产环境,我建议添加一个HTTP引荐来源网址(这样可以防止未经授权的域滥用我们的API密钥)。 点击创建,然后Google将生成一个API密钥。
对于OAuth客户端ID,再次点击新建凭据,然后选择OAuth客户端ID 。 选择Web应用程序作为应用程序类型,并至少输入一个授权JavaScript来源。 对于本地开发环境,它可能是http:// localhost或类似名称。 我们不需要输入授权的重定向URI。 单击创建将生成客户端ID和客户端密钥。
填写必要的字段后,我们应该能够在“ 凭据”部分中看到我们的凭据。 在下一步的浏览器选项卡中将此信息保持打开状态。
最初设定
获取代码副本
现在已经设置了API凭据,我们应该签出现有演示应用程序的源代码 。
git clone git@github.com:sitepoint-editors/gmail-api-javascript-example.git
文件夹01 - Basic client
包含上一篇文章中的代码。 这就是我们感兴趣的。
输入我们的凭证
我们应该在index.html
输入我们的凭据:
var clientId = 'xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com';
var apiKey = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
调整身份验证范围
最后,我们应该调整身份验证范围 。 以前,我们要求对用户的Gmail帐户具有只读访问权限。 但是,发送电子邮件需要更多权限。 修改index.html
的范围变量定义,如下所示(请注意,范围变量是用空格分隔的字符串):
var scopes =
'https://www.googleapis.com/auth/gmail.readonly '+
'https://www.googleapis.com/auth/gmail.send';
如上一篇文章中所述,始终最佳做法始终是在处理其他人的数据(尤其是与他们的电子邮件帐户一样敏感的数据)时请求最低限度的权限。 这两个范围是我们此应用程序所需的全部。 奇怪的是,有一个类似命名的作用域( compose
)&#x