如何在Ionic应用中通过Gmail API（TS/JS）发送邮件？

我来帮你把这个邮件发送功能补全，基于你已经写好的GAPI初始化代码，咱们一步步搞定：

1. 先搞定用户授权流程 #

你已经配置了正确的权限范围（https://mail.google.com/是发送邮件必需的，readonly是额外的，没问题），接下来需要让用户完成授权登录。在Ionic里可以做个按钮触发授权：

// 触发Gmail授权的函数
async function authorizeGmail() {
  try {
    const authResponse = await gapi.auth2.getAuthInstance().signIn({
      scope: 'https://mail.google.com/ https://www.googleapis.com/auth/gmail.readonly'
    });
    console.log('用户授权成功:', authResponse);
    // 授权通过后就可以调用发送邮件的逻辑了
  } catch (error) {
    console.error('授权失败:', error);
    // 这里可以给用户弹个提示，比如"授权失败，请重试"
  }
}

// 初始化GAPI后加载auth2模块（可以放在你的Ionic页面初始化钩子里，比如ngOnInit或者ionViewWillEnter）
gapi.load('client:auth2', () => {
  gapi.auth2.init({
    client_id: gapiKeys.client_id,
    discoveryDocs: ["https://www.googleapis.com/discovery/v1/apis/gmail/v1/rest"]
  });
});

2. 构建符合Gmail要求的邮件内容 #

Gmail API要求邮件内容是Base64编码的RFC 2822格式字符串，我们得先把收件人、主题、正文拼成标准格式，再做编码：

// 生成符合要求的编码邮件内容
function createEncodedEmail(to: string, subject: string, body: string) {
  // 按照RFC 2822规范拼接邮件头和正文
  const emailContent = [
    `To: ${to}`,
    `Subject: ${subject}`,
    'Content-Type: text/html; charset=utf-8', // 支持HTML格式正文
    '',
    body
  ].join('\n');

  // Base64编码，同时替换Gmail要求的特殊字符（+换成-，/换成_，去掉末尾的=）
  const encodedEmail = btoa(emailContent)
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/, '');
  
  return encodedEmail;
}

3. 调用Gmail API发送邮件 #

授权通过+邮件内容准备好后，就可以调用发送接口了：

// 发送邮件的核心函数
async function sendEmail(to: string, subject: string, body: string) {
  try {
    // 先检查用户是否已授权，没授权就先触发授权
    const authInstance = gapi.auth2.getAuthInstance();
    if (!authInstance.isSignedIn.get()) {
      await authorizeGmail();
    }

    const encodedEmail = createEncodedEmail(to, subject, body);

    // 调用Gmail API发送邮件，"me"代表当前授权的用户
    const response = await gapi.client.gmail.users.messages.send({
      'userId': 'me',
      'resource': {
        'raw': encodedEmail
      }
    });

    console.log('邮件发送成功，返回信息:', response.result);
    // 这里可以给用户弹成功提示
    return response.result;
  } catch (error) {
    console.error('邮件发送失败:', error);
    // 处理具体错误，比如配额不足、网络问题等
    throw error;
  }
}

4. Ionic集成的关键注意事项 #

• 平台配置：如果是原生iOS/Android应用，要在Google Cloud控制台里把对应的客户端ID类型改成Android/iOS，并且配置好包名/签名；Web应用的话要把http://localhost:8100（或者你的实际域名）加到授权的JavaScript来源和重定向URI里。
• 用户体验：第一次授权时Google会显示权限请求，一定要在应用里提前说明为什么需要这个权限，避免用户拒绝。
• 错误处理：要覆盖常见错误场景，比如用户取消授权、网络断开、API配额用完等，给用户友好的提示。

最后检查配置 #

别忘了在Google Cloud控制台里确认：

• Gmail API已经启用
• OAuth客户端ID的配置和你的Ionic应用类型匹配
• 授权的来源/重定向URI正确无误

内容的提问来源于stack exchange，提问作者S. Park