您在 BigQuery 將資料載入資料表或建立任何空白資料表時,都必須指定一個架構。在本文中,這個架構的作用是定義及描述與 BigQuery 的 Gmail 記錄相關聯的欄位。
瞭解如何在 BigQuery 中指定及修改架構。
架構更新
本文中的架構會不時更新。如果範本資料表中新增了欄位,往後使用該範本產生的每日資料表就會包含新的欄位。因此,如果您想要查詢新欄位,請查詢在範本更新後產生的每日資料表。
Gmail 架構
event_info
類型 |
RECORD |
模式 |
REQUIRED |
說明 |
事件的一般資訊 |
event_info.elapsed_time_usec
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
事件的總時間長度 (以微秒為單位) |
event_info.success
類型 |
BOOLEAN |
模式 |
REQUIRED |
說明 |
事件成功時傳回 True,否則傳回 False
舉例來說,如果郵件遭到政策拒絕,這個值就會是 False。
|
event_info.timestamp_usec
類型 |
INTEGER |
模式 |
REQUIRED |
說明 |
這個事件開始的時間 (採用 UNIX 時間戳記格式,以微秒為單位) |
message_info
類型 |
RECORD |
模式 |
NULLABLE |
說明 |
與郵件相關的一般資訊 |
message_info.action_type
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
這個事件所代表的動作。
值
|
說明
|
1
|
內送 SMTP 伺服器所收到的郵件。
|
2
|
Gmail 接受並準備傳送的郵件。這通常是接在 1 之後的步驟;如果您是透過 Gmail 傳送郵件,這會是第一個步驟。如果是內送郵件,系統會在這裡評估含有拒絕處理規則的政策,例如會拒絕內送郵件的附件規範政策。另請參閱 68。
|
3
|
郵件由 Gmail 處理,例如傳送至 Gmail 信箱或其他服務器。這通常是接在 2 之後的步驟。系統會在這裡評估含有「拒絕」處理規則以外的政策,例如會根據檔案類型或其他條件移除附件的附件規範政策。
|
10
|
由外寄 SMTP 伺服器傳送的郵件。
|
14
|
Gmail 嘗試傳送郵件時發生的暫時性錯誤,且系統已經排定要重新嘗試傳送郵件。這通常是由於外部或內部伺服器暫時無法使用所造成,請稍後再試一次。舉例而言,Gmail 嘗試將郵件傳送至某外部 SMTP 伺服器,但卻收到暫時性錯誤。
|
18
|
郵件無法傳送且遭到退回。有時您可以藉由閱讀 message_info.description 中的內容來瞭解發生什麼情況。常見的原因包括:
|
19
|
郵件遭 Gmail 捨棄,常見的原因包括:
-
如果傳送出去的郵件觸發了管理員隔離區處置,系統就會捨棄原始的郵件並在「管理員隔離區」中新增一份郵件的副本。
-
如果傳送的是日誌郵件,則系統會傳送包裝後的內部郵件,但會捨棄原始的郵件。
-
如果是內送郵件,Gmail 可以加以封鎖並捨棄郵件。舉例來說:
-
郵件不符合 RFC 5322 規範。
-
寄件者違反大量寄件者指南。
-
如果政策移除了主要傳送路徑並新增了其他路徑,則系統就會捨棄原始郵件並將郵件複本傳送至新增的路徑。
-
如果系統無法辨識收件者且又根據政策新增了其他路徑,就會捨棄原始郵件並將郵件複本傳送至新增的路徑。
|
45 |
Google 網路論壇的子系統已允許傳送郵件。 |
46 |
郵件的收件者地址是 Google 網路論壇,且郵件已傳送給啟用郵件傳送功能的 Google 網路論壇的所有成員。 |
48
|
內送 SMTP 伺服器收到的待轉發郵件。
|
49
|
由外寄 SMTP 伺服器透過轉發功能傳送的郵件。
|
51 |
郵件已傳送/儲存到 Google 網路論壇儲存空間。 |
54 |
郵件遭到 Google 網路論壇儲存空間系統拒絕。 |
55
|
政策修改了主要傳送路徑或郵件收件者,導致系統將郵件重新插入 Gmail 中。
|
68
|
Gmail 接受並準備傳送的郵件。
這類似於 2,但郵件是透過 Gmail 伺服器傳送。
|
69
|
使用者變更了 Gmail 中的垃圾郵件分類。
例如將郵件標示為垃圾郵件、網路詐騙郵件或非垃圾郵件等。
|
70
|
郵件在傳送到 Gmail 後遭重新分類為垃圾郵件或網路詐騙郵件。
|
71 |
使用者收到這封郵件後,在收件匣中執行某項動作。送達後動作包括開啟郵件、點選郵件中的連結,以及下載附件。BigQuery 的匯出結果不會提供動作的詳細資料。 |
|
message_info.attachment
類型 |
RECORD |
模式 |
REPEATED |
說明 |
郵件附件的相關資訊
系統會針對每個附件重複這項記錄。
|
message_info.attachment.file_extension_type
類型 |
STRING |
模式 |
NULLABLE |
說明 |
副檔名 (非 MIME 部分類型),不包含句號。 |
message_info.attachment.malware_family
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
如果系統在處理郵件時偵測到惡意軟體,就會設定惡意軟體類別。如果沒有偵測到惡意軟體,系統就不會設定這個欄位。
值
|
說明
|
1
|
已知的惡意程式類型
|
2
|
病毒或蠕蟲類型的惡意軟體
|
3
|
可能有害的電子郵件內容
|
4
|
電子郵件可能含有垃圾內容
|
5
|
其他類型的惡意軟體
|
|
message_info.attachment.sha256
類型 |
STRING |
模式 |
NULLABLE |
說明 |
附件的 SHA256 雜湊 |
message_info.connection_info
類型 |
RECORD |
模式 |
NULLABLE |
說明 |
傳送郵件所用連線的相關資訊 |
message_info.connection_info.authenticated_domain
類型 |
RECORD |
模式 |
REPEATED |
說明 |
已驗證的網域名稱與驗證機制的清單 |
message_info.connection_info.authenticated_domain.name
類型 |
STRING |
模式 |
NULLABLE |
說明 |
經過驗證的網域名稱 |
message_info.connection_info.authenticated_domain.typ
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
郵件驗證類型 (例如 SPF、DKIM)。
值
|
說明
|
1
|
SPF
|
2
|
DKIM
|
3
|
DKIM_PROXY
|
4
|
XOAR_SPF
|
5
|
XOAR_DKIM
|
6 |
ARC_SPF
|
7 |
ARC_DKIM
|
|
message_info.connection_info.client_host_zone
類型 |
STRING |
模式 |
NULLABLE |
說明 |
郵件寄件者的用戶端代管區域 |
message_info.connection_info.client_ip
類型 |
STRING |
模式 |
NULLABLE |
說明 |
啟動郵件的郵件用戶端 IP 位址 |
message_info.connection_info.dkim_pass
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
顯示系統是否使用至少一種 DKIM 簽名來驗證郵件 |
message_info.connection_info.dmarc_pass
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
顯示郵件是否通過 DMARC 政策評估 |
message_info.connection_info.dmarc_published_domain
類型 |
STRING |
模式 |
NULLABLE |
說明 |
系統用於評估 DMARC 政策的網域名稱 |
message_info.connection_info.failed_smtp_out_connect_ip
類型 |
STRING |
模式 |
REPEATED |
說明 |
遠端 MX 記錄中所有 IP 的清單;Gmail 嘗試連線至這些 IP,結果失敗 |
message_info.connection_info.ip_geo_city
類型 |
STRING |
模式 |
NULLABLE |
說明 |
系統根據轉發 IP 計算出來的最接近城市 |
message_info.connection_info.ip_geo_country
類型 |
STRING |
模式 |
NULLABLE |
說明 |
系統根據轉發 IP 顯示的 ISO 國家/地區代碼 |
message_info.connection_info.is_internal
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
顯示郵件是否在客戶擁有的網域中傳送 |
message_info.connection_info.is_intra_domain
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
顯示郵件是否在相同的網域中傳送 |
message_info.connection_info.smtp_in_connect_ip
類型 |
STRING |
模式 |
NULLABLE |
說明 |
MTA 用戶端連線的遠端 IP 位址 (要傳送至 Gmail 的內送 SMTP) |
message_info.connection_info.smtp_out_connect_ip
類型 |
STRING |
模式 |
NULLABLE |
說明 |
(從 Gmail 寄出的) SMTP 連線的遠端 IP 位址 |
message_info.connection_info.smtp_out_remote_hos
類型 |
STRING |
模式 |
NULLABLE |
說明 |
針對外寄 SMTP 連線列出連線起點的網域、目標網域或智慧主機 |
message_info.connection_info.smtp_reply_code
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
內送與外寄 SMTP 連線的 SMTP 回覆代碼
通常是「2xx」、「4xx」或「5xx」。
|
message_info.connection_info.smtp_response_reason
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
內送連線的 SMTP 轉發代碼詳細原因
值
|
說明
|
1
|
系統拒絕或接受郵件時考量的預設原因
|
3
|
惡意軟體
|
4
|
DMARC 政策
|
5
|
Gmail 政策不支援的附件
|
6
|
超過接收上限
|
7
|
帳戶資料量超過配額
|
8
|
PTR 記錄不正確
|
9
|
收件者不存在
|
10
|
自訂政策
|
12
|
違反 RFC 規範
|
13
|
明確垃圾郵件
|
14
|
阻斷服務
|
15
|
惡意連結或垃圾連結
|
16
|
IP 曾有不良記錄
|
17
|
網域曾有不良記錄
|
18
|
IP 列在公開的即時黑名單 (RBL) 中
|
19 |
由於發生阻斷服務 (DoS) 的情形,導致郵件暫時遭拒 |
20 |
由於發生阻斷服務 (DoS) 的情形,導致郵件永久遭拒 |
|
message_info.connection_info.smtp_tls_cipher
類型 |
STRING |
模式 |
NULLABLE |
說明 |
用於對 SMTP 伺服器建立安全連線的傳輸層安全標準 (TLS) 加密名稱,例如:AES128-SHA、ECDHE-ECDSA-AES256-GCM-SHA384 和 DES-CBC3-SHA。 |
message_info.connection_info.smtp_tls_state
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
系統所建立對 SMTP 伺服器的連線類型。系統只會針對明確處理 SMTP 連線的事件記錄進行設定。
值
|
說明
|
0
|
非 TLS
|
1
|
傳輸層安全標準 (TLS)
|
|
message_info.connection_info.smtp_tls_version
類型 |
STRING |
模式 |
NULLABLE |
說明 |
用於對 SMTP 伺服器建立安全連線的傳輸層安全標準 (TLS) 版本 (例如 TLSv1.2)
|
message_connection_info.smtp_user_agent_ip
類型 |
STRING |
模式 |
NULLABLE |
說明 |
內送 SMTP 連線的郵件使用者代理程式 IP 位址 |
message_info.connection_info.spf_pass
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
顯示郵件是否已使用 SPF 進行驗證 |
message_info.connection_info.tls_required_but_unavailable
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
外寄 SMTP 連線必須使用 TLS,但沒有任何有效的憑證 |
message_info.description
類型 |
STRING |
模式 |
NULLABLE |
說明 |
使用者可理解的郵件相關情況說明 |
message_info.destination
類型 |
RECORD |
模式 |
REPEATED |
說明 |
郵件收件者的相關資訊
系統會針對每個收件者重複這項記錄。
|
message_info.destination.address
類型 |
STRING |
模式 |
NULLABLE |
說明 |
收件者的電子郵件地址 |
message_info.destination.rcpt_response
message_info.destination.selector
message_info.destination.service
類型 |
STRING |
模式 |
NULLABLE |
說明 |
位於郵件目的地的服務。目的地會有多種服務與選取器配對。您可以使用這兩個欄位來決定系統要將郵件傳送至哪項服務。
服務
|
選取器
|
說明
|
gmail-ui
|
sent-on-behalf-of-user
|
系統已將郵件傳送至 Gmail,並且將副本保留在使用者的 Gmail「寄件備份」匣中。
|
gmail-ui
|
null
|
郵件已傳送至 Gmail。
|
mailing-list-server
|
spam-check
|
系統已將郵件傳送至 Google 網路論壇並檢查是否含有垃圾內容。
|
mailing-list-server
|
null
|
系統已將郵件傳送至 Google 網路論壇。
|
mailing-list-server
|
moderation
|
系統已將郵件傳送至 Google 網路論壇,目前正等待管理員審核。
|
mailing-list-server
|
archive
|
系統已將郵件傳送至 Google 網路論壇並且已封存。
|
gmail-for-work-catchall
|
|
郵件的收件者不明,且郵件已根據全部接收規則傳送。
|
smtp-outbound
|
gmail-delivery-server
|
郵件已傳送至外寄 SMTP 伺服器並由 Gmail 傳送伺服器處理。
|
smtp-outbound
|
google-apps-for-work
|
郵件已傳送至外寄 SMTP 伺服器並由 Google Workspace Basic 處理。
|
smtp-outbound
|
google-apps-for-work-starter
|
郵件已傳送至外寄 SMTP 伺服器並由 Google Workspace Basic 處理。
|
smtp-outbound
|
gmail-notification
|
郵件已傳送至外寄 SMTP 伺服器並由 Gmail 通知處理。
|
smtp-outbound
|
relay
|
郵件已傳送至外寄 SMTP 伺服器並由 Gmail 轉發伺服器處理。
|
smtp-outbound
|
gmail
|
郵件已傳送至外寄 SMTP 伺服器。
|
smtp-outbound
|
gmail-for-work
|
郵件已傳送至外寄 SMTP 伺服器並由 Gmail 根據企業政策新增。
|
smtp-outbound
|
null
|
郵件已傳送至外寄 SMTP 伺服器。
|
smtp-outbound-to-gmail |
gmail-delivery-server |
郵件已傳送至外寄 SMTP 伺服器、Gmail 或 Google Workspace 收件者。 |
|
message_info.destination.smime_decryption_success
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
僅限內送郵件
一旦設定,就表示系統已嘗試針對此收件者進行 S/MIME 解密,而值則表示完成狀態。
如略過則不會設定
|
message_info.destination.smime_extraction_success
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
僅限內送郵件
一旦設定,就表示系統已嘗試針對此收件者進行 S/MIME 擷取,而值則表示完成狀態。
如略過則不會設定
|
message_info.destination.smime_parsing_success
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
僅限內送郵件
一旦設定,就表示系統已嘗試針對此收件者進行 S/MIME 剖析,而值則表示完成狀態。
如略過則不會設定
|
message_info.destination.smime_signature_verification_success
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
僅限內送郵件
一旦設定,就表示系統已嘗試針對此收件者進行 S/MIME 簽名驗證,而值則表示完成狀態。
如略過則不會設定
|
message_info.flattened_destinations
類型 |
STRING |
模式 |
NULLABLE |
說明 |
具有所有經過簡化處理的收件者相關資訊的字串,使用的格式為:
「service_for_recipient1:selector_for_recipient1:address_for_recipient1、
service_for_recipient2:selector_for_recipient2:address_for_recipient2」。
|
message_info.flattened_triggered_rule_info
類型 |
STRING |
模式 |
NULLABLE |
說明 |
具有所有已觸發的規則相關資訊的字串,使用的格式為 JSON |
message_info.is_policy_check_for_sender
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
如果已針對寄件者評估政策規則,值為 True (表示郵件經過處理,準備寄出)
如果已針對收件者評估政策規則,值為 False (表示郵件經過處理,準備內送)
|
message_info.is_spam
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
如果郵件遭分類為垃圾郵件,值為 True |
message_info.link_domain
類型 |
STRING |
模式 |
REPEATED |
說明 |
從郵件內文中的連結網址所擷取的網域 |
message_info.message_set
message_info.message_set.type
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
郵件集類型是用於描述郵件的屬性。例如,描述郵件是內送郵件、外寄郵件或內部郵件。
值
|
說明
|
1
|
郵件為內送郵件,也就是說,郵件的寄件者位於您的網域以外。這個郵件集不會與郵件集 10 同時出現。
|
2
|
郵件為外寄郵件,也就是說,郵件的收件者位於您的網域以外。這個郵件集不會與郵件集 10 同時出現。
|
4 |
郵件含有您的政策所定義的不當內容。 |
6 |
郵件觸發了您設定的「限制使用者只能與經過授權的電子郵件地址或網域通信」自訂規則。 |
7
|
Gmail 已將郵件分類為垃圾郵件。
|
8
|
郵件正在傳送中 (外寄郵件)
|
9
|
郵件正在接收中 (內送郵件)
|
10
|
郵件為網域內部的郵件
|
11
|
郵件的寄件者或收件者位於您的網域以外。
已收到的郵件:如果缺少郵件集 27,系統就無法驗證寄件者,並會因此將郵件的寄件者視為您網域以外的使用者。
|
12
|
郵件的部分收件者來自您網域內部,部分收件者則位於網域外。這個郵件集會在發生以下情況時出現:
|
13 |
郵件集的類型不明。 |
15 |
用於檢查郵件的政策已連結至特定 Gmail 使用者。 |
18 |
郵件沒有預設路徑。 |
19 |
您設定的網域預設路徑地址清單與郵件通信者相符。 |
20 |
郵件來自您已封鎖的寄件者地址。 |
21 |
已透過傳輸層安全標準 (TLS) 傳送郵件,且具備有效的安全資料傳輸層 (SSL) 憑證。 |
22 |
已透過傳輸層安全標準 (TLS) 傳送郵件。 |
24 |
此郵件的收件者不明。 |
25 |
郵件是用於回覆未傳送郵件的無法傳送回條。 |
26 |
郵件觸發了您在網域預設路徑中設定的重新轉送規則。 |
27
|
寄件者已順利通過 SPF/DKIM/DMARC 驗證。如果寄件者未經驗證,系統就不會信任寄件者的網域,也不會將郵件視為內部郵件。
|
28 |
Exchange 日誌正在將郵件封存至 Google 保管箱。 |
29 |
郵件已透過 SMTP 轉發服務轉送。 |
30 |
郵件收件者與您明確設定的網域轉送或網域預設路徑收件者 (而非規則運算式模式) 相符。 |
31 |
郵件符合您所設定的網域預設路徑條件。 |
32 |
這是 Exchange 日誌郵件為了封存至 Google 保管箱所建立的郵件。
|
33 |
郵件必須透過安全連線 (例如 TLS) 傳送。 |
34 |
用於檢查郵件的政策已連結至特定群組 (而非個別 Gmail 使用者)。 |
35 |
郵件無寄件者地址或可能為 Exchange 日誌郵件,因此 SMTP 轉發服務無法對其進行驗證。系統會在稍後執行 SMTP RCPT 指令時再次檢查郵件。 |
36 |
郵件已啟用增強型垃圾郵件過濾功能。 |
37 |
郵件已通過驗證,可以使用 SMTP 轉發服務。 |
39 |
寄件者所屬網域已通過驗證,可以進行轉發。 |
40 |
郵件的寄件者為 Google Workspace 使用者 (所屬網域已通過驗證,可以進行轉發)。 |
41 |
寄件者已通過 SMTP 驗證,Gmail 正在嘗試為寄件者的網域驗證 SMTP 轉發服務。
|
42 |
郵件的寄件地址未經驗證。 |
43 |
已透過別名表格重新轉送郵件。 |
44 |
郵件觸發了會變更郵件收發路徑的規則。 |
45 |
郵件將傳送至全部接收的帳戶,並轉發至內部部署伺服器 (不會套用記錄系統政策)。 |
46 |
郵件已略過垃圾郵件篩選器。 |
47
|
郵件遭到內送閘道設定中的「標記後傳送」資訊偵測為垃圾郵件。
|
48 |
由於垃圾郵件覆寫政策的緣故,系統未檢查郵件是否含有垃圾內容 (未由 SMTP 檢查)。 |
49 |
一律覆寫郵件的拒絕垃圾內容設定。 |
50 |
郵件符合您設定的網域轉送條件。 |
51 |
郵件觸發了您為網域轉送設定的重新轉送規則。 |
55 |
郵件是由 Exchange 日誌產生設定所建立。 |
57
|
郵件是透過您設定的內送閘道規則所接收。
|
60 |
郵件受到 Gmail 的機密模式保護。 |
61 |
郵件被安全沙箱攔截。 |
62 |
您為網域預設路徑設定的地址清單與 SMTP 的郵件收件者 (而非郵件通信者) 相符。 |
63 |
郵件觸發了您為網域轉送或網域預設路徑設定的網域層級重新轉送規則。 |
|
message_info.num_message_attachments
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
郵件附件的數量 |
message_info.payload_size
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
郵件酬載的大小 (以位元組為單位) |
message_info.rfc2822_message_id
類型 |
STRING |
模式 |
NULLABLE |
說明 |
郵件的 RFC 2822 郵件 ID。如要查看這項資訊,請在 Gmail 郵件中選取 [顯示原始郵件]。 |
message_info.smime_content_type
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
郵件的頂層 S/MIME 類型,以 Content-Type 標頭表示。
值
|
說明
|
0
|
郵件沒有可辨識的 S/MIME 內容類型。
|
1
|
具有已分離簽名的 S/MIME 郵件
以內容類型 multipart/signed 搭配參數 protocol=application/pkcs7-signature 來表示。
|
2
|
具有不透明簽名的 S/MIME 郵件
以內容類型 application/pkcs7-mime 或 application/x-pkcs7-mime 搭配參數 smime-type=signed-data 來表示。
|
3
|
經過加密的 S/MIME 郵件
以內容類型 application/pkcs7-mime 或 application/x-pkcs7-mime 搭配參數 smime-type=enveloped-data 來表示。
|
4
|
經過壓縮的 S/MIME 郵件
以內容類型 application/pkcs7-mime 或 application/x-pkcs7-mime 搭配參數 smime-type=compressed-data 來表示。
|
|
message_info.smime_encrypt_message
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
僅限外寄郵件
如果已經設定且為 True,表示郵件應該已經過加密。
|
message_info.smime_extraction_success
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
一旦設定,就表示系統已進行內送 S/MIME 處理 (如略過則不會設定),而值則表示完成狀態。
注意:目前未設定。
|
message_info.smime_packaging_success
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
僅限外寄郵件
一旦設定,就表示系統已嘗試進行 S/MIME 封裝 (如略過則不會設定),而值則表示完成狀態。
|
message_info.smime_sign_message
類型 |
BOOLEAN |
模式 |
NULLABLE |
說明 |
僅限外寄郵件
如果已經設定且為 True,表示郵件應該已經過簽署。
|
message_info.smtp_relay_error
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
如果 Gmail 拒絕了 SMTP 轉發要求,這個錯誤代碼就會提供拒絕原因的相關資訊。
值
|
說明
|
1
|
驗證錯誤
|
2
|
超過每日頻率限制。
|
3
|
超過尖峰頻率限制。
|
4
|
濫用 SMTP 轉發服務。
|
5
|
超過每位使用者頻率限制。
|
|
message_info.source
類型 |
RECORD |
模式 |
NULLABLE |
說明 |
寄件者相關資訊。 |
message_info.source.address
類型 |
STRING |
模式 |
NULLABLE |
說明 |
寄件者的電子郵件地址 |
message_info.source.from_header_address
類型 |
STRING |
模式 |
NULLABLE |
說明 |
顯示在郵件標頭的「寄件者」標頭地址,例如「johndoe@solarmora.com」 |
message_info.source.from_header_displayname
類型 |
STRING |
模式 |
NULLABLE |
說明 |
顯示在郵件標頭的「寄件者」標頭顯示名稱,例如「John Doe」
注意:如果記錄過長,或是記錄中觸發的規則 (triggered_rule_info) 數量過多,這個欄位就可能不會顯示完整資訊。
|
message_info.source.selector
message_info.source.service
類型 |
STRING |
模式 |
NULLABLE |
說明 |
郵件的來源服務。您可以根據這兩個欄位判定郵件是來自哪項服務以及為何產生郵件。
服務
|
選取器
|
說明
|
calendar
|
send
|
來自 Google 日曆的通知
|
gmail-ui
|
read-receipt
|
Gmail 讀取回條功能
|
gmail-ui
|
autoforward
|
Gmail 自動轉送功能
|
gmail-ui
|
unsubscribe
|
Gmail 取消訂閱功能
|
gmail-ui
|
canned-response
|
由 Gmail 罐頭回應功能所傳送的郵件
|
gmail-ui
|
vacation-response
|
Gmail 休假回覆功能
|
gmail-ui
|
send
|
透過 Gmail 網頁介面所傳送的郵件
|
docs
|
share
|
來自 Google 雲端硬碟的共用通知
|
groups
|
groups-ui
|
透過 Google 網路論壇所傳送的郵件
|
keep
|
invites
|
透過 Google Keep 所傳送的邀請
|
mailing-list-server
|
custom-replies
|
來自 Google 網路論壇的自動回覆
|
mailing-list-server
|
null
|
透過 Google 網路論壇傳送
|
mailing-list-server
|
moderation
|
透過 Google 網路論壇審核傳送
|
mailing-list-server
|
to-archive
|
透過 Google 網路論壇封存傳送
|
google-apps-script
|
user
|
透過 Google Apps Script 傳送
|
mail-fetcher
|
null
|
由 Gmail 郵件擷取程式所提取的郵件
|
gmail-for-work
|
quarantine-delivery
|
隔離區管理員釋出的郵件
|
gmail-for-work
|
quarantine-notification
|
通知原始寄件者離郵件被拒且遭隔離的未傳送回應
|
gmail-for-work
|
policy
|
郵件觸發了網域管理員配置的設定
|
gmail-for-work
|
comprehensive-mail-storage
|
因全方位郵件儲存空間設定而傳送至 Gmail 伺服器
|
smtp-inbound
|
null
|
從 Google 的 SMTP 伺服器插入至 Gmail 傳送管道的郵件
|
smtp-msa
|
null
|
在驗證模式中從 Google 的 SMTP 伺服器插入至 Gmail 傳送管道的郵件
|
smtp-relay |
轉發 |
透過 SMTP 轉發設定轉送的郵件 |
smtp-relay
|
gmail-for-work
|
透過 SMTP 轉發設定轉送的郵件
|
google-spreadsheets
|
google-forms-receipt
|
來自 Google 試算表的通知
|
google-spreadsheets
|
google-forms-invite
|
來自 Google 試算表的共用邀請
|
unified-notifications
|
google-apps
|
來自 Google Workspace 的通知
|
unified-notifications
|
null
|
來自 Google 系統的通知
|
|
message_info.spam_info
類型 |
RECORD |
模式 |
NULLABLE |
說明 |
垃圾郵件分類資訊 |
message_info.spam_info.classification_reason
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
郵件遭分類為垃圾郵件、網路詐騙郵件等類別的原因。
值
|
說明
|
1
|
預設的垃圾郵件分類原因
|
2
|
郵件分類取決於寄件者過往的動作
|
3
|
可疑的內容
|
4
|
可疑的連結
|
5
|
可疑的附件
|
6
|
在 Google Workspace 管理控制台 > [Gmail 設定] 中定義的自訂政策
|
7
|
DMARC
|
8
|
公開即時黑名單中的網域
|
9
|
違反 RFC 標準
|
10
|
違反 Gmail 政策
|
11
|
機器學習判斷
|
12
|
寄件者信譽
|
13
|
明確垃圾郵件
|
14 |
網路詐騙和惡意軟體的進階防護措施 |
|
message_info.spam_info.classification_timestamp_usec
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
垃圾郵件分類時間戳記 |
message_info.spam_info.disposition
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
Gmail 垃圾郵件分類的結果
值
|
說明
|
1
|
系統視為乾淨的郵件 (非垃圾郵件或惡意軟體)
|
2
|
垃圾郵件
|
3
|
網路詐騙
|
4
|
可疑
|
5
|
惡意軟體
|
|
message_info.spam_info.ip_whitelist_entry
類型 |
STRING |
模式 |
NULLABLE |
說明 |
系統根據 Gmail 設定中的自訂規則將郵件分類時,用於告知分類結果的 IP 許可清單項目。
|
message_info.structured_policy_log_info
類型 |
RECORD |
模式 |
NULLABLE |
說明 |
系統針對郵件評估的政策相關結構化資訊,包括日誌與已偵測到的檔案類型相關資訊。 |
message_info.structured_policy_log_info.detected_file_types
類型 |
RECORD |
模式 |
REPEATED |
說明 |
檔案類型相關資訊。 |
message_info.structured_policy_log_info.detected_file_types.category
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
MIME 類型類別
值
|
說明
|
1
|
無法辨識的檔案類型。
|
2
|
Microsoft Office 文件,包括文書處理工具、試算表工具、簡報工具、資料庫文件以及 PDF 檔案。檔案不一定經過加密。
|
3
|
影片與多媒體,例如 MPEG、Quicktime、WMV
|
4
|
音樂與音訊,例如 MP3、AAC、WAV
|
5
|
圖片,例如 JPEG、BMP、GIF
|
6
|
封存檔,例如 ZIP、TAR、TGZ
|
7
|
執行檔,例如 EXE、COM、JS
|
8
|
經過加密的 Office 文件。
|
9
|
未經加密的 Office 文件。
|
|
message_info.structured_policy_log_info.detected_file_types.mime_type
類型 |
STRING |
模式 |
NULLABLE |
說明 |
檔案的 MIME 類型 |
message_info.structured_policy_log_info.exchange_journal_info
類型 |
RECORD |
模式 |
NULLABLE |
說明 |
郵件的 Exchange 日誌相關資訊 |
message_info.structured_policy_log_info.exchange_journal_info.recipients
類型 |
STRING |
模式 |
REPEATED |
說明 |
(Google 已知) 已納入日誌記錄的郵件的網域收件者 |
message_info.structured_policy_log_info.exchange_journal_info.rfc822_message_id
類型 |
STRING |
模式 |
NULLABLE |
說明 |
已納入日誌記錄的郵件的 RFC 822 郵件 ID |
message_info.structured_policy_log_info.exchange_journal_info.timestamp
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
已納入日誌記錄的郵件的時間戳記 (以秒為單位) |
message_info.structured_policy_log_info.exchange_journal_info.unknown_recipients
類型 |
STRING |
模式 |
REPEATED |
說明 |
已納入日誌記錄的郵件的 Google 未知網域收件者 |
message_info.subject
類型 |
STRING |
模式 |
NULLABLE |
說明 |
郵件主旨。
注意:如果記錄過長,或是記錄中觸發的規則 (triggered_rule_info) 數量過多,這個欄位就可能不會顯示完整資訊。
|
message_info.triggered_rule_info
類型 |
RECORD |
模式 |
REPEATED |
說明 |
針對郵件觸發的政策規則相關資訊 |
message_info.triggered_rule_info.consequence
類型 |
RECORD |
模式 |
REPEATED |
說明 |
因為已觸發的規則而套用至郵件的結果相關資訊 |
message_info.triggered_rule_info.consequence.action
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
針對結果採取的動作
值
|
說明
|
0
|
結果為免人工管理
|
3
|
將郵件移至管理員隔離區中
|
4
|
修改主要傳送目標
|
5
|
新增傳送目標
|
6
|
已加入郵件標頭
|
7
|
覆寫郵件收件者
|
9
|
將郵件加入至指定的郵件集
|
10
|
修改郵件的標籤
|
11
|
郵件主旨前置文字
|
12
|
在郵件中加入註腳
|
13
|
移除郵件內文
|
14
|
根據全方位郵件儲存空間設定,在使用者的信箱中儲存郵件副本。
|
15
|
使用罐頭文字取代附件
|
16
|
需要安全的郵件傳送
|
17
|
郵件無法傳送且已退回
|
18
|
為收件者封存至 Google 保管箱
|
20 |
使用 S/MIME 加密外寄郵件 |
21 |
變更透過 SMTP 接收郵件時的收件者 |
|
message_info.triggered_rule_info.consequence.reason
類型 |
STRING |
模式 |
NULLABLE |
說明 |
套用結果的原因。通常會包含觸發該結果的規則的專屬說明。 |
message_info.triggered_rule_info.consequence.subconsequence
類型 |
RECORD |
模式 |
REPEATED |
說明 |
主要結果的子結果相關資訊 |
message_info.triggered_rule_info.consequence.subconsequence.action
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
針對子結果採取的動作
請參閱結果動作,瞭解可能出現的值。
|
message_info.triggered_rule_info.consequence.subconsequence.reason
類型 |
STRING |
模式 |
NULLABLE |
說明 |
套用子結果的原因。通常會包含觸發該結果的規則的專屬說明。 |
message_info.triggered_rule_info.policy_holder_address
類型 |
STRING |
模式 |
NULLABLE |
說明 |
政策觸發了規則的政策擬定者的電子郵件地址 |
message_info.triggered_rule_info.rule_name
類型 |
STRING |
模式 |
NULLABLE |
說明 |
管理員在管理控制台中提供的自訂規則說明 |
message_info.triggered_rule_info.rule_type
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
自訂規則類型
值
|
說明
|
0
|
圍牆花園
|
7
|
不當內容
|
8
|
內容規範
|
10
|
轉送已接收的郵件
|
11
|
轉送已傳送的郵件
|
12
|
垃圾郵件覆寫
|
14
|
封鎖的寄件者
|
15
|
附加註腳
|
16
|
附件規範
|
17
|
傳輸層安全性 (TLS) 規範
|
18
|
網域預設轉送
|
19
|
在保管箱接受內送電子郵件日誌
|
20
|
外寄轉發
|
21
|
隔離摘要
|
22
|
替代安全路徑
|
23
|
別名表格
|
24
|
全方位郵件儲存空間
|
25
|
轉送規則
|
26
|
內送閘道
|
27
|
S/MIME
|
28
|
第三方電子郵件封存
|
31 |
S/MIME 限制遞送 |
|
message_info.triggered_rule_info.spam_label_modifier
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
說明自訂規則垃圾郵件分類結果
值
|
說明
|
0
|
無動作 - 規則遵守 Gmail 垃圾郵件分類判斷結果。
|
1
|
垃圾郵件 - 規則將郵件分類為垃圾郵件。
|
2
|
非垃圾郵件 - 規則將郵件分類為非垃圾郵件。
|
|
message_info.triggered_rule_info.string_match
類型 |
RECORD |
模式 |
REPEATED |
說明 |
因發現相符字串而觸發規則。例如,觸發了含有相符字串相關資訊的內容規範規則。 |
message_info.triggered_rule_info.string_match.attachment_name
類型 |
STRING |
模式 |
NULLABLE |
說明 |
附件名稱 (系統在該附件中擷取自二進位檔案的文字中找到相符字串)。
注意:這個欄位目前未填入任何內容。
|
message_info.triggered_rule_info.string_match.match_expression
類型 |
STRING |
模式 |
NULLABLE |
說明 |
管理員在管理控制台中設定的比對運算式。
注意:如果記錄過長,或是記錄中觸發的規則 (triggered_rule_info) 數量過多,這個欄位就可能不會顯示完整資訊。
|
|
message_info.triggered_rule_info.string_match.matched_string
類型 |
STRING |
模式 |
NULLABLE |
說明 |
觸發規則的字串。系統會以「*」或「.」來隱藏機密資訊
注意:如果記錄過長,或是記錄中觸發的規則 (triggered_rule_info) 數量過多,這個欄位就可能不會顯示完整資訊。
|
|
message_info.triggered_rule_info.string_match.predefined_detector_name
類型 |
STRING |
模式 |
NULLABLE |
說明 |
如果這與預先定義偵測工具相符,則顯示預先定義偵測工具的名稱 |
message_info.triggered_rule_info.string_match.source
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
郵件中相符字串的位置
值
|
說明
|
0
|
不明
|
1
|
郵件內文,包括文字格式附件
|
2
|
二進位格式附件
|
3
|
郵件標頭
|
4
|
主旨
|
5
|
寄件者標頭
|
6
|
收件者標頭
|
7 |
原始郵件 |
|
message_info.triggered_rule_info.string_match.type
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
比對類型
值
|
說明
|
0
|
未定義
|
1
|
規則運算式比對
|
2
|
預先定義偵測工具比對
|
3
|
簡要內容比對
|
4
|
非 ASCII 比對
|
|
message_info.upload_error_category
類型 |
INTEGER |
模式 |
NULLABLE |
說明 |
將郵件上傳至目的地時發生錯誤
值
|
說明
|
0
|
未分類的暫時性錯誤
|
1
|
收件者帳戶過於忙碌
|
2
|
解析收件者網域時發生錯誤
|
3
|
收件者的伺服器拒絕連線
|
4
|
儲存空間已用盡的收件者
|
|