Gmail Activity Events

本文档列出了各种类型的 Gmail 活动事件的事件和参数。您可以通过调用 Activities.list() 并使用 applicationName=gmail 来检索这些事件。

Gmail 审核事件类型

导出给 dasher 客户的 Gmail 审核事件的类型。 此类事件会随 type=delivery_type 一起返回。

Gmail 审核事件

活动详情
事件名称 delivery
参数
event_info

message

活动的一般信息。列出的嵌套参数可使用完整参数名称作为过滤条件。

  • event_info.mail_event_type(整数)

    记录的事件类型。由于对于 Gmail 审核日志,eventName 始终是一个常量 (delivery),因此此字段有助于确定实际发生的事件。

    可能的值包括:

    • 0:邮件事件类型不明
    • 1:已发送消息
    • 2:收到消息
    • 3:某位 Gmail 用户手动将邮件归类为垃圾邮件。例如,用户将邮件标记为垃圾邮件、钓鱼式攻击邮件或非垃圾邮件。
    • 4:Gmail 在递送后将邮件标记为垃圾邮件。有若干因素可能会导致此问题,包括发件人声誉不佳或病毒哈希较新。
    • 5:邮件已被隔离
    • 6:从隔离区释放了邮件
    • 7:首次打开邮件
    • 8:邮件已标记为未读
    • 9:首次回复邮件
    • 10:首次转发消息
    • 11:使用 Gmail 账号转发设置自动转发的邮件
    • 12:邮件已移至收件箱
    • 13:邮件已移至回收站
    • 14:邮件已从回收站中移除
    • 15:点击了邮件正文中的链接
    • 16:在预览附件时,点击了邮件附件中的链接
    • 17:已下载一个或多个邮件附件
    • 18:一个或多个邮件附件已保存到 Google 云端硬盘
    • 19:邮件中的一项或多项 Google 云端硬盘内容已保存到收件人的 Google 云端硬盘中
    • 20:已为邮件应用分类标签
    • 21:邮件分类标签更改
    • 22:从邮件中移除了分类标签
    • 23:已为所有邮件附件应用分类标签
    • 24:对所有邮件附件更改了分类标签
    • 25:从所有邮件附件中移除了分类标签
    • 26:已归档邮件
    • 27:已永久删除邮件
    • 28:已预览一个或多个邮件附件
    • 29:邮件已保存为草稿
    • 30:邮件无法递送,并已退回
    • 31:已查看邮件,包括首次阅读和后续阅读。如需详细了解 iOS 已知问题,请参阅 Google Workspace 已知问题。
    • 32:已下载的消息
    • 33:应用代表用户访问了邮件
    • 34:授予了受托

示例请求
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/gmail?eventName=delivery&maxResults=10&access_token=YOUR_ACCESS_TOKEN
管理控制台消息格式
An event happened during mail delivery