如何将Gmail账户关联到Google Cloud Pub/Sub主题以监控新邮件？

1. 启用Gmail API并配置服务账户权限 #

• 先在Google Cloud控制台的API库中启用Gmail API。
• 若使用Google Workspace（原G Suite）账户，需给服务账户配置域范围委派：
  • 进入IAM与Admin → 服务账户，找到目标服务账户，点击“编辑”并勾选“启用G Suite域范围委派”。
  • 登录Google Workspace管理控制台，进入安全 → API控制 → 域范围委派，添加服务账户的客户端ID，同时授权以下Gmail API权限：https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/gmail.modify（至少保留readonly权限以监听新邮件）。
• 若为个人Gmail账户，需通过OAuth 2.0流程让服务账户获取该邮箱的访问权限。

2. 用Ruby调用Gmail API的watch方法绑定邮箱与Pub/Sub主题 #

在Rails应用中添加以下代码，调用Gmail API的watch接口完成绑定：

require 'google/apis/gmail_v1'
require 'googleauth'

# 初始化Gmail API客户端
gmail = Google::Apis::GmailV1::GmailService.new
gmail.authorization = Google::Auth::ServiceAccountCredentials.make_creds(
  json_key_io: File.open('path/to/your/service-account-key.json'),
  scope: ['https://www.googleapis.com/auth/gmail.readonly'],
  # Workspace账户需指定要模拟的目标邮箱，个人账户可删除此参数
  sub: 'target-user@your-domain.com'
)

# 构建watch请求，绑定收件箱与指定主题
watch_request = Google::Apis::GmailV1::WatchRequest.new(
  topic_name: 'projects/your-project-id/topics/your-topic-name',
  label_ids: ['INBOX'],
  label_filter_action: 'include'
)

# 执行watch操作
response = gmail.watch_user('me', watch_request)
puts "绑定成功，初始历史ID: #{response.history_id}"

• 替换path/to/your/service-account-key.json为你的服务账户密钥文件路径。
• 替换your-project-id和your-topic-name为你的Google Cloud项目ID和Pub/Sub主题名称。

3. 配置Pub/Sub主题权限 #

在Google Cloud控制台的Pub/Sub主题页面，进入权限设置：

• 添加成员gmail-api-push@system.gserviceaccount.com，授予其Pub/Sub Publisher角色，确保Gmail服务能向该主题发布消息。

4. 验证配置 #

给目标Gmail邮箱发送测试邮件，检查你的Pub/Sub订阅是否收到推送消息。消息会包含新邮件的历史记录ID，可通过该ID调用Gmail API获取具体邮件内容。

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