Gmail Activity Events

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

Gmail 审核事件类型

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

Gmail 审核事件

。

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

message

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

  • event_info.mail_event_type（整数）

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

    可能的值包括：

    • 0：未知邮件事件类型。邮件递送期间的此阶段不会显示在安全调查工具中。如需了解详情，请参阅 message_info.action_type。
    • 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