如何基于标签ID添加G-Suite Pub/Sub订阅过滤器

核心过滤规则 #

你可以直接利用Gmail Pub/Sub事件中的labelIds字段构建过滤规则，精准筛选出**接收（INBOX标签）和发送（SENT标签）**的邮件事件，表达式如下：

labelIds:(INBOX OR SENT)

这个规则会让订阅只推送带有INBOX或SENT系统标签的历史事件，自动过滤掉归档、标记已读、移动文件夹等无关操作触发的事件。

应用过滤器的两种方式 #

1. 创建新订阅时添加过滤

使用gcloud命令行工具创建订阅时，直接指定--filter参数：

gcloud pubsub subscriptions create [你的订阅名称] \
  --topic=[你的Gmail Pub/Sub主题名称] \
  --filter="labelIds:(INBOX OR SENT)"

2. 修改现有订阅添加过滤

如果已经创建了订阅，可通过命令行更新：

gcloud pubsub subscriptions update [你的订阅名称] \
  --filter="labelIds:(INBOX OR SENT)"

或者通过Google Cloud控制台操作（对应你提供的截图）：

• 进入Pub/Sub订阅详情页，找到“过滤器”设置项
• 在输入框中填入上述过滤表达式，保存即可

验证过滤效果 #

1. 发送一封测试邮件到你的Gmail账户，检查Pub/Sub是否收到INBOX标签的事件
2. 从你的Gmail账户发送一封测试邮件，检查Pub/Sub是否收到SENT标签的事件
3. 执行归档、标记已读等操作，确认这些操作不会触发订阅推送

注意事项 #

• INBOX和SENT是Gmail的系统固定标签ID，无需自定义，直接使用即可
• 过滤规则支持逻辑运算符（OR/AND/NOT），如果后续需要扩展筛选条件，可以基于此调整

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