前提

采用谷歌服务账号的方式授权访问API，授权方式为oauth2.0的客户端模式。 开发前，先需要完成以下授权过程

1. 申请好Google workspace, 需要可访问域名，并配置解析，如yamibuy.com
2. 创建组织邮箱，如damon.li@yamibuy.com
3. 通过邮箱登录Google Cloud Platform,选择凭据，创建一个用于邮箱凭证的项目
4. 进入创建好的项目，选择创建凭据-->服务账号，账户名随便输入，如mail-service-account，一路点击完成
5. 编辑刚创建好的服务账号，记录好唯一ID，如：118087448170978300761，后续添加访问权限使用
6. 点击添加密钥-->创建新密钥-->保存下载好json文件,后续使用
7. 登录Google workspace，点击安全性-->API控件-->全网域授权-->管理全网域授权
8. 点击新增, 客户端ID填写刚才创建的服务账号的唯一ID，授权域地址填写https://www.googleapis.com/auth/gmail.send
9. 访问Google Gmail Api,点击启用谷歌API-->选择刚才创建的项目启用
10. 权限授权完成

API说明

• 授权获取token
  • 地址：https://oauth2.googleapis.com/token
  • 请求方式：POST
  • 请求协议：applicaiton/x-www-form-urlencoded
  • 请求参数：

  {
     # 谷歌源码写死的类型
     "grant_type":"urn:ietf:params:oauth:grant-type:jwt-bearer",
     "assertion":"Jwt-Token"
  }
  • Jwt-token 格式：

  {
      header:{
          algorithm: 'RS256',
          type: 'JWT',
          keyId: '[serviceAccountPrivateKeyId]'
      }
      paylload:{
          id: '[serviceAccountPrivateKeyId]',
          issuer: '[serviceAccountId]',
          audience: '[tokenServerEncodedUrl]'，
          issuedAt: '[当前时间]'，
          expiration: '当前时间+3600',
          subject: '[email]',
          scope: 'https://www.googleapis.com/auth/gmail.send'
      }
  }
• 发送邮件
  • 地址：https://www.googleapis.com/gmail/v1/users/me/messages/send
  • 请求方式：Post
  • 请求协议：application/json
  • 请求参数:

  {
      raw: "[Base64.encodeUrlSafe后的 RFC2822邮件]"
  }
  • RFC2822格式邮件