Gmail Enhanced_办公效率 skill-PHP中文网

Gmail Enhanced

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

增强的 Gmail 集成，提供标签管理、附件处理、高级搜索、邮件解析及自动化邮件处理等高级功能。

Gmail 增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能

功能概述

Gmail 增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能增强功能是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

Gmail Enhanced

具备强大自动化功能的高级 Gmail 集成。

功能

1. 高级搜索

构建复杂查询（AND、OR、NOT）
日期范围筛选
附件筛选
标签筛选
在附件内容中搜索

2. 标签管理

创建、重命名、删除标签
嵌套标签（类文件夹结构）
自定义标签颜色
标签统计信息

3. 附件处理

下载附件
上传并发送附件
按类型/大小筛选附件
将附件提取至云存储

4. 邮件处理

自动对邮件分类
从邮件中提取数据
自动回复规则
邮件模板
退信检测

5. 邮件解析

提取结构化数据
解析发票、收据
提取联系人信息
HTML 解析

前提条件

在 Google Cloud Console 中启用 Gmail API
创建 OAuth 2.0 凭据
下载 credentials.json
生成 tokens.json（首次运行时需完成身份验证）

配置

export GMAIL_CREDENTIALS_PATH="/path/to/credentials.json"
export GMAIL_TOKEN_PATH="/path/to/tokens.json"

或直接将凭据文件置于默认路径：

~/.credentials/gmail-credentials.json
~/.credentials/gmail-token.json

使用方法

发送邮件

from gmail_enhanced import GmailClient

gmail = GmailClient()

# 简单邮件
gmail.send(
    to="recipient@example.com",
    subject="Hello",
    body="Email content"
)

# 带附件的邮件
gmail.send(
    to="recipient@example.com",
    subject="Report",
    body="Please find the report attached",
    attachments=["report.pdf"]
)

高级搜索

# 复杂查询
results = gmail.search(
    query="from:boss@company.com",
    label="INBOX",
    after="2024/01/01",
    has_attachments=True
)

# 使用 OR 的组合查询
results = gmail.search_or([
    "subject:urgent",
    "label:important"
])

标签管理

# 创建标签
label = gmail.create_label("Projects/Work/Q1", color="#4A90E2")

# 获取标签统计信息
stats = gmail.get_label_stats("INBOX")

# 为邮件添加标签
gmail.add_labels(["Label1", "Label2"], message_ids)

附件处理

# 从搜索结果中下载附件
attachments = gmail.search_attachments(
    query="subject:invoice",
    save_dir="./downloads"
)

# 上传附件并发送
gmail.send(
    to="recipient@example.com",
    subject="File",
    attachments=["/path/to/file.pdf"]
)

自动分类

# 创建规则
gmail.add_rule(
    name="Categorize invoices",
    query="subject:invoice has:attachment",
    add_labels=["Processed/Invoices"]
)

# 执行所有规则
gmail.process_rules()

API 参考

核心方法

方法	说明
`send(to, subject, body, attachments, cc, bcc)`	发送邮件
`search(query, max_results, label)`	搜索邮件
`get_message(msg_id, format)`	获取邮件详情
`delete_message(msg_id)`	移入垃圾箱
`archive_message(msg_id)`	归档邮件

标签方法

方法	说明
`create_label(name, color)`	创建标签
`rename_label(old_name, new_name)`	重命名标签
`delete_label(name)`	删除标签
`get_labels()`	列出全部标签
`get_label_stats(label)`	获取标签统计信息

附件方法

方法	说明
`download_attachment(msg_id, attachment_id, save_path)`	下载附件
`search_attachments(query, save_dir)`	搜索并下载附件
`get_attachment_info(msg_id)`	列出邮件中的附件

自动化方法

方法	说明
`add_rule(name, query, actions)`	创建处理规则
`process_rules()`	执行全部规则
`create_template(name, subject, body)`	创建邮件模板
`send_template(template_name, to, variables)`	使用模板发送邮件

解析方法

方法	说明
`parse_email(msg_id)`	提取结构化数据
`extract_invoice(msg_id)`	解析发票数据
`extract_contacts(msg_id)`	提取邮箱地址

邮件查询语法

基础语法：
  from:user@example.com
  to:user@example.com
  subject:keyword
  "精确短语"

时间筛选：
  after:2024/01/01
  before:2024/12/31
  older_than:7d
  newer_than:2h

标志符：
  has:attachment
  has:drive
  is:unread
  is:starred
  is:important

标签：
  label:INBOX
  label:Work

组合查询：
  from:boss AND subject:urgent
  (from:alice OR from:bob) AND is:unread

错误处理

常见错误：

invalid_credentials：需重新完成身份验证
rate_limit：等待后重试
not_found：邮件 ID 无效
permission_denied：检查 OAuth 权限范围（scopes）

所需权限范围（Scopes）

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.labels
https://www.googleapis.com/auth/gmail.modify