通知

Duet AI 現已更名為 Google Workspace 專用 Gemini。瞭解詳情

在 BigQuery 中設定 Gmail 記錄功能

支援這項功能的版本:Enterprise Standard 和 Enterprise Plus 和 Education Standard 和 Education Plus。  版本比較

Gmail 記錄會儲存 Gmail 傳送郵件的各階段記錄。如要分析 Gmail 傳送郵件的流程,請將 Gmail 記錄指派給 BigQuery 專案中的資料集。指派 Gmail 記錄後,您就可以閱覽報告。   

注意:在您設定 BigQuery 的 Gmail 記錄前,系統建立的 Gmail 記錄無法匯出至 BigQuery。

為簡化 BigQuery 工作,並方便您集中管理所有 BigQuery 資料,自 2023 年 2 月開始,我們會合併 BigQuery 中的 Gmail 記錄Workspace 記錄與報告。您可以在 Google 管理控制台集中管理所有 Workspace 服務的 BigQuery 記錄和報告。建議您盡快將 Gmail 的 BigQuery 檢視表、查詢和指令碼遷移至 Workspace 記錄和報告。如需詳細步驟,請參閱「將 BigQuery 中的 Gmail 記錄遷移至 Workspace 記錄」。

將 Gmail 記錄指派給 BigQuery 資料集

  1. 登入 Google 管理控制台

    請使用「管理員帳戶」(結尾「不是」@gmail.com) 登入。

  2. 進入管理控制台首頁後,依序前往「應用程式」接下來「Google Workspace」接下來「Gmail」接下來「設定」接下來

    「BigQuery 電子郵件記錄」

  3. 按一下「啟用」。
  4. 輸入要在設定摘要內顯示的簡述。
  5. 選取想要使用 Gmail 記錄功能的 BigQuery 專案 (請選取您擁有寫入權限的專案)。
  6. 在儲存 Gmail 記錄的位置輸入資料集名稱,或使用預設名稱 gmail_logs_dataset
  7. (選用) 按一下「限制資料集只能放在特定地理位置」接下來 選取地區 (例如美國)。
  8. 按一下「儲存」

  9. 儲存設定後,請返回 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:更新日後的架構。

      注意:請勿移除這些服務帳戶或變更其角色,這些是必要帳戶。
  10. 如要確認這些服務帳戶是否已成功新增,請將滑鼠游標移至新建立的資料集,然後在資料集名稱旁邊點選「向下箭頭」。
  11. 點選「分享資料集」,這樣一來,每日電子郵件記錄就會匯出至 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 天內復原。

這對您有幫助嗎?

我們應如何改進呢?
true
立即開始 14 天免費試用

享盡公司專用電子郵件帳戶、線上儲存空間、共用日曆、視訊會議等好處。立即開始免費試用 G Suite

搜尋
清除搜尋內容
關閉搜尋
主選單
16250650743691821327
true
搜尋說明中心
true
true
true
true
true
73010
false
false