如何无需存储令牌监控Gmail企业邮箱，特定邮件未到即告警？

关于Pub/Sub的适用性 #

Pub/Sub确实能实现邮件监控，但对你这个单一的“当日结束前检查特定邮件是否到达”需求来说，确实有点冗余。它主打事件驱动的消息分发，需要配置Gmail推送通知、维护订阅者服务，对于简单的定时检查场景，额外的复杂度和维护成本完全没必要。

更轻量的实现方案（推荐） #

你的需求本质是定时任务+邮件查询+告警触发，结合企业邮箱的授权要求，推荐以下落地步骤：

1. 授权方案：服务账号+域范围委派（无需长期存储用户令牌） #

针对Google Workspace的企业邮箱，用服务账号+域范围委派就能解决授权问题，不用存用户令牌，首次配置后长期有效（除非权限或密钥变更）：

• 在Google Cloud控制台创建服务账号，启用Gmail API
• 到Workspace admin控制台，给该服务账号授予https://www.googleapis.com/auth/gmail.readonly的域范围权限
• 用服务账号的密钥文件，直接模拟专用业务邮箱的身份调用Gmail API，不需要用户手动授权刷新

2. 核心逻辑：定时查询+告警触发 #

用定时任务（比如Cloud Scheduler、系统Cron）在当日结束前（比如23:30）执行以下操作：

• 调用Gmail API的users.messages.list接口，按条件查询当日收到的目标邮件（比如指定发件人、主题关键词）
  • 示例查询参数：q=from:指定发件人邮箱 subject:"目标主题" after:当日00:00 before:当日23:59
• 如果查询结果为空，直接触发告警（比如调用内部告警系统、发运维通知邮件、推Slack/Teams消息）

3. 代码示例（Python） #

from google.oauth2 import service_account
from googleapiclient.discovery import build
import datetime

# 配置服务账号和目标邮箱信息
SERVICE_ACCOUNT_KEY = 'service-account-key.json'
TARGET_EMAIL = '业务专用邮箱@你的域名.com'
API_SCOPES = ['https://www.googleapis.com/auth/gmail.readonly']

# 构建Gmail服务对象
credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_KEY, scopes=API_SCOPES).with_subject(TARGET_EMAIL)
gmail_service = build('gmail', 'v1', credentials=credentials)

# 生成当日时间范围
today = datetime.date.today()
start_timestamp = f"{today}T00:00:00Z"
end_timestamp = f"{today}T23:59:59Z"

# 自定义查询条件，按需调整
search_query = f'from:业务对接方@xxx.com subject:"每日运营数据" after:{start_timestamp} before:{end_timestamp}'

# 查询邮件
search_result = gmail_service.users().messages().list(userId=TARGET_EMAIL, q=search_query).execute()
matched_messages = search_result.get('messages', [])

if not matched_messages:
    # 这里替换成你的告警逻辑
    print("未收到目标邮件，触发告警！")
else:
    print(f"已收到{len(matched_messages)}封符合条件的邮件")

补充说明 #

• 授权有效期：服务账号密钥可以设置1年有效期，到期前在Cloud控制台更新即可，无需用户重复授权
• 定时任务选择：用Google Cloud的话，Cloud Scheduler可以直接触发Cloud Function运行代码，不用自己搭服务器；内部环境用Cron脚本就行

内容的提问来源于stack exchange，提问作者smansou