Gmail Activity Events

本文列出各種類型 Gmail 活動事件的事件和參數。您可以呼叫 Activities.list() 並使用 applicationName=gmail 擷取這些事件。

Gmail 稽核事件類型

匯出給 Google Workspace 客戶的 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