Gemini API集成Gmail：自动化会议跟进与回复精选教程
先说一个硬前提：Gemini API的权限配置与Gmail接口绑定必须提前完成。如果这一步没做，后续所有API调用都会直接返回403错误，没有任何回旋余地。简单来说，Gemini Pro模型本身不具备邮件发送能力，必须通过Google Workspace Admin SDK获取显式授权，才有权操作Gmail API。
典型场景如下：会议结束后30分钟内，你需要把决策结论、待办事项及责任人同步给参会人员，同时附上原始议程链接。手动复制粘贴不仅容易遗漏关键字段，更怕发错收件人。这时，用Python调用Gemini Pro生成结构化邮件，再通过Gmail API自动发送或存为草稿，是一条非常高效的自动化路径。
确认Gemini API调用权限与Gmail接口绑定状态
这一步必须卡死。打开Google Cloud Console，依次进入“API和服务”→“凭据”页面，点开你的服务账号，在“已授予的OAuth范围”里确认是否包含了https://www.googleapis.com/auth/gmail.send和https://www.googleapis.com/auth/gmail.readonly。如果缺了任意一个，需要手动去“编辑”→“添加OAuth范围”，勾选这两项再保存。有一个特别容易踩的坑：【未启用gmail.send权限，会导致sendAs.create调用直接失败，而且错误日志里完全不提示具体缺失了哪一项】。这个问题排查起来非常棘手，很多人卡在这里半天找不到原因。
用Python脚本调用Gemini Pro生成结构化会议跟进邮件
这个方案适用于你已经拿到了会议文字稿——比如Google Meet的自动转录文本，或者Zoom导出的TXT文件。Gemini Pro输出的内容可以直接封装成Gmail API能认的JSON payload。
第一步，安装必要的依赖包：pip install google-generativeai google-api-python-client google-auth-httplib2 google-auth-oauthlib
第二步，准备好会议文本变量meeting_transcript。注意，Gemini Pro的输入上限是28000个字符，如果文本超长，需要先用textwrap.shorten()做截断处理，同时保留首尾的逻辑锚点，确保关键信息不丢失。
第三步，调用Gemini Pro生成邮件正文。这一步的提示词约束非常关键：要明确要求它“生成一封Gmail格式的会议跟进邮件”，具体格式包括——主题行以【跟进】开头并带会议日期；正文严格分三段：第一段简述结论（不超过3句），第二段列出待办事项（每个事项前标上“负责人：”和“截止日：”前缀），第三段附上议程链接（固定写“原始议程：[INSERT_LINK]”）；不使用项目符号，用换行分隔；不需要加称呼和落款。
第四步，把生成结果封装成RFC 5322标准邮件体，用base64.urlsafe_b64encode()编码后填入raw字段，构造最终的payload字典。
通过Gmail API发送邮件的两种路径
路径一：用已验证的服务账号密钥文件直接发送。这种方式适合后台定时任务，完全无人值守。加载credentials.json，调用build('gmail', 'v1', credentials=creds)，然后执行service.users().messages().send(userId='me', body={'raw': encoded_payload}).execute()，一气呵成。
路径二：在用户浏览器中触发OAuth2.0授权流，更适合前端交互式场景。先跳转到授权链接（带上scope、client_id和redirect_uri），用户同意授权后拿到code，再用code换取access_token，后续调用同一个send接口。需要重点记住的是：方法二首次授权后会返回一个refresh_token，这个东西必须持久化存储。后续可以用它来静默刷新access_token，避免让用户反复授权——这对体验是灾难性的。
自动化注入会议纪要到Gmail草稿箱（免立即发送）
有时候我们并不想立即发出邮件，而是希望人工复核一遍再发。这种情况下，可以跳过send步骤，改用drafts.insert接口。
构造payload时，把raw字段内容包裹进{'message': {'raw': '...'}, 'id': None}这个结构里，然后调用service.users().drafts().create(userId='me', body=payload).execute()。执行成功后，返回的draft对象中会包含一个id字段。这个ID用途很大——后续无论是用drafts.send发送，还是用drafts.delete删除，都得靠它。
这一步不会触发任何推送通知，草稿只会安静地躺在当前用户的Gmail“草稿”文件夹里，和手动撰写的效果完全一致。对于需要多人协作审核后统一发送的场景，这条路径显然是更稳妥的选择。