支援這項功能的版本:Enterprise Standard 和 Enterprise Plus 和 Education Standard 和 Education Plus。 版本比較
Gmail 記錄會儲存 Gmail 傳送郵件的各階段記錄。如要分析 Gmail 傳送郵件的流程,請將 Gmail 記錄指派給 BigQuery 專案中的資料集。指派 Gmail 記錄後,您就可以閱覽報告。
注意:在您設定 BigQuery 的 Gmail 記錄前,系統建立的 Gmail 記錄無法匯出至 BigQuery。
將 Gmail 記錄指派給 BigQuery 資料集
-
-
進入管理控制台首頁後,依序前往「應用程式」「Google Workspace」「Gmail」「設定」
「BigQuery 電子郵件記錄」。
- 按一下「啟用」。
- 輸入要在設定摘要內顯示的簡述。
- 選取想要使用 Gmail 記錄功能的 BigQuery 專案 (請選取您擁有寫入權限的專案)。
- 在儲存 Gmail 記錄的位置輸入資料集名稱,或使用預設名稱 gmail_logs_dataset。
- (選用) 按一下「限制資料集只能放在特定地理位置」 選取地區 (例如美國)。
-
按一下「儲存」。
- 儲存設定後,請返回 BigQuery 專案。專案中目前會顯示含有下列資訊的資料集:
- 標準角色:專案擁有者、專案編輯者與專案檢視者
- 以下四個服務帳戶為指定的資料集編輯者:
- gmail-for-work-logs-writer1@system.gserviceaccount.com:寫入記錄。
- gmail-for-work-logs-writer2@system.gserviceaccount.com:寫入記錄。
- gmail-for-work-logs-recoverer@system.gserviceaccount.com:自動復原不慎遭到移除的範本資料表。
- gmail-for-work-logs-schema-updater@system.gserviceaccount.com:更新日後的架構。
注意:請勿移除這些服務帳戶或變更其角色,這些是必要帳戶。
- 如要確認這些服務帳戶是否已成功新增,請將滑鼠游標移至新建立的資料集,然後在資料集名稱旁邊點選「向下箭頭」。
- 點選「分享資料集」,這樣一來,每日電子郵件記錄就會匯出至 BigQuery。
變更最多可能需要 24 小時才會生效,但通常不會這麼久。瞭解詳情
daily_ 資料表
您在 BigQuery 中啟用電子郵件記錄功能後,系統就會將一份名為「daily_」的資料表新增至資料集。這份資料表是為每日資料表提供架構的範本。您建立 daily_ 範本後,系統就會自動在您的資料集中建立每日資料表。上述程序完成後即可查看記錄。
關於 daily_ 資料表的注意事項:
- 內容一律為空白且沒有到期時間。
- 請勿移除、修改或重新命名這個資料表,也不要在其中加入資料。
-
這是以日期分區的資料表。也就是說,系統會根據事件發生時的格林威治標準時間 (GMT),將實際資料寫入名為「daily_YYYYMMDD」的資料表。
Gmail 記錄查詢
查詢範例
嘗試按照 BigQuery 的部分 Gmail 記錄查詢範例操作。這些範例都是 Gmail 記錄功能的常見用途。
自訂查詢
透過 BigQuery 的 Gmail 記錄架構編寫自訂查詢。
SQL 查詢語法
BigQuery 支援兩種 SQL 查詢語法
部分欄位的資料可能不完整
請注意,BigQuery 中每個資料列的大小上限是 1 MB,因此為了讓每筆記錄小於 1MB - 1KB 以顯示在 BigQuery 中,系統可能會省略部分欄位內容。1 KB 是特意留出的緩衝空間。
如果記錄過長,或是記錄中觸發的規則 (triggered_rule_info) 數量過多,下列欄位就可能不會顯示完整資訊:
message_info.subject
message_info.source.from_header_displayname
message_info.triggered_rule_info.string_match.match_expression
message_info.triggered_rule_info.string_match.matched_string
詳情請參閱 BigQuery 的 Gmail 記錄架構。
相關資訊
沙箱到期時間
以下 BigQuery 沙箱物件的有效期限是 60 天:
- 資料表
- 分區
- 分區資料表中的分區
- 檢視表
您可以為資料表變更預設資料表到期時間。
如果資料表過期或者遭到移除,可以在 2 天內復原。