BigQuery での Gmail ログのスキーマ

BigQuery でテーブルにデータを読み込んだり、空のテーブルを作成したりするときは、スキーマを指定する必要があります。この記事で紹介するスキーマには、Gmail ログに関連付けられたフィールドの定義や説明が含まれます。

この記事内のスキーマは随時更新されます。テンプレート テーブルに新しいフィールドが追加されると、そのテンプレートから生成された翌日の日次テーブルには、新しいフィールドが含まれるようになります。新しいフィールドをクエリするには、テンプレートの更新後に生成された日次テーブルに対してクエリを実行してください。

詳しくは、BigQuery でのスキーマの指定と変更についてのページをご覧ください。

フィールド名 event_info
RECORD
モード 必須
説明 イベントの一般的な情報

 

フィールド名

event_info.client_context.client_type

STRING
モード NULLABLE
説明 操作が行われたクライアントまたはデバイスの種類(ウェブ、iOS、Android、IMAP、POP3、API など)

 

フィールド名 event_info.client_context.session_context.delegate_user_email
STRING
モード NULLABLE
説明 アカウント所有者に委任されて操作を行った代理ユーザーのメールアドレス

 

フィールド名 event_info.client_context.session_context.dusi
STRING
モード NULLABLE
説明 特定のデバイスでのユーザー セッションの識別子

 

フィールド名 event_info.elapsed_time_usec
INTEGER
モード NULLABLE
説明 このイベントが発生した期間(マイクロ秒)

 

フィールド名 event_info.mail_event_type
INTEGER
モード NULLABLE
説明

ログに記録されたイベントの種類。このイベントの種類は、セキュリティ調査ツールの Gmail ログイベントのイベント属性に対応しています。 以下の値があります。

0: 不明なメール イベントの種類

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: メールがダウンロードされた

: 2024 年 4 月から 7 月の間に有効になった BigQuery エクスポートには、2024 年 4 月からエクスポートを有効にした日までのビューの履歴イベントは含まれません。2024 年 8 月以降に有効になった BigQuery エクスポートには、エクスポートを有効にした日の 6 か月前までさかのぼったビューの履歴イベントが含まれます。

 

フィールド名 event_info.success
BOOLEAN
モード 必須
説明

イベントが成功した場合は true、失敗した場合は false。たとえば、ポリシーによってメールが拒否された場合、値は false になります。

 

フィールド名 event_info.timestamp_usec
INTEGER
モード 必須
説明 このイベントの開始時刻(マイクロ秒単位の UNIX タイムスタンプ形式)

 

フィールド名 message_info
RECORD
モード NULLABLE
説明 メールに関する一般的な情報

 

フィールド名 message_info.action_type
INTEGER
モード NULLABLE
説明

イベントで示されているメール配信アクション。 値は次のいずれかです。

1: メールは受信 SMTP サーバーによって受信されました

2: メールが Gmail で受け付けられ、配信準備が完了しました。通常、この処理は「1」のステップに続いて行われますが、Gmail からの送信メールの場合は最初に行われます。受信メールの場合、拒否処理を含むポリシーは通常この段階で評価されます(例: 受信メールを拒否する添付ファイルのコンプライアンス ポリシー)。

3: Gmail がメールへの対応を行いました。(例: Gmail のメールボックスや別のサーバーに送信済み)。通常、この処理は「2」のステップに続いて行われます。拒否以外の処理を含むポリシーはこの段階で評価されます(例: ファイル形式などの条件に基づいて添付ファイルを削除する、添付ファイルのコンプライアンス ポリシー)。

10: メールが送信 SMTP サーバーによって送信されました

14: Gmail でメールを配信しようとしたときに一時的なエラーが発生したため、再試行がスケジュールされました。これは通常、外部サーバーまたは内部サーバーが一時的に利用できないことが原因で発生します。後で再試行してください。たとえば、Gmail で外部の SMTP サーバーにメールを配信しようとしたところ、一時的なエラーが返された場合です。

18: メールは配信できず、返送されました。message_info.description を読むことで、何が起きたかを確認できる場合もあります。一般的な理由は次のとおりです。

  • 受信サーバーがリクエストを受け付けなかった

  • 一時的なエラーが多すぎるためメールを配信できなかった(この表の 14 を参照)。

  • ポリシーの評価が遅れたためメールが拒否された

  • 受信者を認識できず、メインの配信ルートを変更するポリシーがトリガーされていない

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 Export には、操作の詳細が含まれます

 

フィールド名 message_info.attachment
RECORD
モード REPEATED
説明

メッセージの添付ファイルに関する情報。この記録は添付ファイルごとに繰り返されます。

 

フィールド名 message_info.attachment.file_extension_type
STRING
モード NULLABLE
説明 ファイル拡張子(MIME パートタイプではありません)。ピリオド(.)は含まれません

 

フィールド名 message_info.attachment.file_name
STRING
モード NULLABLE
説明 添付ファイルの名前。

 

フィールド名 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.type
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
説明 1 つ以上の DKIM 署名を使用してメールが認証されたかどうかを示す

 

フィールド名 message_info.connection_info.dmarc_pass
BOOLEAN
モード NULLABLE
説明 メールが DMARC ポリシー評価に合格したかどうかを示す

 

フィールド名 message_info.connection_info.dmarc_pass
STRING
モード NULLABLE
説明 DMARC ポリシーの評価に使用するドメイン名

 

フィールド名 message_info.connection_info.failed_smtp_out_connect_ip
STRING
モード REPEATED
説明 Gmail が接続しようとしてできなかった、リモート MX レコード内のすべての 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 アドレス(SMTP から Gmail への受信)

 

フィールド名 message_info.connection_info.smtp_out_connect_ip
STRING
モード NULLABLE
説明 Gmail からの SMTP 接続のリモート IP アドレス

 

フィールド名 message_info.connection_info.smtp_out_remote_host
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: DoS(Denial of Service)
  • 15: 悪意のあるリンクまたはスパム行為のあるリンク
  • 16: IP レピュテーション: 低
  • 17: ドメイン レピュテーションが低い
  • 18: 公開リアルタイム ブロックリストに記載されている IP アドレス
  • 19: サービス拒否の制限による一時的な拒否
  • 20: サービス拒否の制限による完全な拒否

 

フィールド名 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
説明 TLS 必須の送信 SMTP 接続に、有効な証明書が存在しない

 

フィールド名 message_info.description
STRING
モード NULLABLE
説明 メールの処理に関する、人間が読み取れる説明

 

フィールド名 message_info.destination
RECORD
モード REPEATED
説明 メッセージの受信者に関する情報。この記録は受信者ごとに繰り返されます。

 

フィールド名 message_info.destination.address
STRING
モード NULLABLE
説明 受信者のメールアドレス

 

フィールド名

message_info.destination.rcpt_response

INTEGER
モード NULLABLE
説明 SMTP RCPT コマンドのレスポンス。値の定義を確認するには、message_info.connection_info.smtp_response_reason に移動します。

 

フィールド名 message_info.destination.selector
STRING
モード NULLABLE
説明

各サービスのサブカテゴリ。値の定義を確認するには、message_info.destination.service に移動します。

 

フィールド名 message_info.destination.service
STRING
モード NULLABLE
説明

このメールの送信先となったサービス。送信先にはサービスとセレクタのペアが多数あります。この 2 つのフィールドを使用して、メッセージの送信先サービスを特定できます。

サービス

セレクタ

説明

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

アーカイブ

メールは 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

リレー

メールは送信 SMTP サーバーに送信され、Gmail のリレーサーバーによって処理されました

smtp-outbound

gmail

メールは送信 SMTP サーバーに送信されました

smtp-outbound

gmail-for-work

メールは送信 SMTP サーバーに送信され、ビジネス向け Gmail のポリシーによって追加されました

smtp-outbound

null

メールは送信 SMTP サーバーに送信されました

smtp-outbound-to-gmail gmail-delivery-server メールは Gmail または Google Workspace の受信者宛に、送信 SMTP サーバーに送信さました

 

フィールド名 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
説明 メール本文のリンク URL から抽出されたドメイン

 

フィールド名 message_info.message_set
RECORD
モード REPEATED
説明

メールが属するメッセージ セットタイプ。詳しくは、message_info.message_set.type をご覧ください。

 

フィールド名 message_info.message_set.type
INTEGER
モード NULLABLE
説明

メッセージ セットタイプとは、メッセージ(メール)を説明する属性です。たとえば、メッセージが受信、送信、内部のいずれであるかを示します。 値は次のいずれかです。

1: メールは受信メール(ドメイン外部から受信したメール)です。このメッセージ セットとメッセージ セット「10」が同時に出現することはありません。

2: メールは送信メール(ドメイン外部の受信者に送信されたメール)です。このメッセージ セットとメッセージ セット「10」が同時に出現することはありません。

4: いずれかのポリシーで定義されている不適切なコンテンツがメールに含まれています

6: 承認済みのアドレスまたはドメインにメールを制限するように設定した、指定ドメインのみアクセス許可のルールが、メールによってトリガーされました

7: メールは Gmail によって迷惑メールに分類されました

8: メールを送信しています(送信メール)

9: メールを受信しています(受信メール)

10: ドメイン内部のメールです

11: メールにドメイン外の送信者または受信者が指定されていました受信メールの場合: メールセット「27がない場合、送信者の認証に失敗しました。メールは、ドメイン外の送信者宛てのメールとして処理されました。

12: メールにドメイン内の受信者とドメイン外の受信者が指定されていました。このメッセージ セットは次の場合に現れます。

  • 受信者が複数います
  • メールを送信中である。受信メールの場合はすべての受信者が同じドメインに属している必要があります
  • メールのアクション タイプが「2」です。複数の受信者が指定されたメールは、単一受信者のメールに分割されます。

13: メールセットのタイプが不明です

15: 照合対象のポリシーは Gmail ユーザーに関連付けられています

18: メールにデフォルトのルートがありません

19: ドメインのデフォルトのルーティング用に設定したアドレスリストが、メールの送受信者と一致しています

20: ブロックされている送信者のリストに含まれるアドレスからのメールです

21: メールは TLS 経由で送信されました。SSL 証明書は有効です

22: メールは TLS 経由で送信されました

24: このメールの受信者が不明です

25: 配信されなかったメールに対する未配信レポートのメールです

26: ドメインのデフォルトのルーティングで設定したルート変更ルールが、メールによってトリガーされました

27: 送信者は SPF、DKIM、DMARC 認証に合格しました。送信者が認証されていない場合、送信者ドメインは信頼されず、内部メールとはみなされません。

28: Exchange ジャーナルがメールを Google Vault にアーカイブしています

29: メールは SMTP リレー経由で転送されました

30: メールの受信者が、ドメインのルーティングまたはドメインのデフォルトのルーティング用の設定で明示的に指定した(正規表現パターンを使わない)受信者のいずれかに一致しました。

31: ドメインのデフォルトのルーティングについて設定した条件にメールが一致しました

32: Google Vault にアーカイブする Exchange ジャーナル メールからメールが作成されました

33: メールは TLS などの安全な接続を介して送信する必要があります

34: 照合対象のポリシーは、個々の Gmail ユーザーではなくグループに関連付けられています

35: SMTP リレーでメールを認証できませんでした。メールの SMTP envelope-from アドレスが空であるか、メールが Exchange ジャーナル メールである可能性があります。後で SMTP RCPT コマンドの実行時に確認されます。

36: 迷惑メールフィルタによる積極的なフィルタリングがメールに対して有効になっています

37: メールは SMTP リレーで認証されます

39: リレー用の認証済みドメインに属する送信者です

40: リレーで認証されるドメイン内の Google Workspace ユーザーからのメールです

41: 送信者は SMTP AUTH で正常に認証されました。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.post_delivery_info
RECORD
モード NULLABLE
説明 配信後のイベントについての情報。これは、message_info.action_type の値が 71 の場合にのみ設定されます。

 

フィールド名 message_info.post_delivery_info.action_type
INTEGER
モード NULLABLE
説明

配信後の操作の種類。 値は次のいずれかです。

1: メールが初めて開封されました

2: メールが未読としてマークされました

3: メールが返信されました

4: メールが転送されました

5: Gmail の設定によりメールが自動転送されました

6: メールが受信トレイに移動されました

7: メールがゴミ箱に移動されました

8: メールがゴミ箱の外に移動されました

9: メール本文のリンクがクリックされました

10: メールの添付ファイルがダウンロードされました

11: 添付ファイルのプレビュー時に、添付ファイル内のリンクがクリックされました

12: メールの添付ファイルが Google ドライブに保存されました

13: アドオン内のリンクがクリックされました

14: メール内の Google ドライブ アイテムがダウンロードされました

15: メール内の Google ドライブ アイテムが、受信者の Google ドライブに保存されました

16: メールに分類ラベルが適用、またはメールの分類ラベルが変更されました

17: メールの添付ファイルに分類ラベルが適用、またはメールの添付ファイルの分類ラベルが変更されました

18: メールがアーカイブされました

19: メールが完全に削除されました

20: メールの添付ファイルがプレビューされました

21: 受信者がメール送信者をブロックしました

22: メールが下書きとして保存されました

23: メールが表示されました(最初と以降の表示を含む)

24: メッセージをダウンロードしました

 

フィールド名 message_info.post_delivery_info.interaction
RECORD
モード NULLABLE
説明 メールのリンク、ドライブのアイテム、添付ファイルに対するユーザーの操作に関する情報。操作の種類は message_info.post_delivery_info.action_type で示されます。

 

フィールド名 message_info.post_delivery_info.interaction.link_url
STRING
モード NULLABLE
説明 操作に関連する URL(リンクのクリック操作についてのみ設定されます)

 

フィールド名 message_info.post_delivery_info.interaction.drive_id
STRING
モード NULLABLE
説明 操作に関連する Google ドライブのアイテムの一意の ID。この ID はドライブ内のアイテムにアクセスするために使用されます。このフィールドは、ドライブの添付ファイルへの操作に対してのみ設定されます。

 

フィールド名 message_info.post_delivery_info.interaction.attachment
RECORD
モード NULLABLE
説明 操作対象の添付ファイル(添付ファイルへの操作についてのみ設定されます)。たとえば、ユーザーがダウンロードする添付ファイルを 1 つだけ選択した場合、このフィールドには選択した添付ファイルに関する情報のみが含まれます。ユーザーが [すべての添付ファイルをダウンロード] を選択した場合、このフィールドにはすべての添付ファイルの情報が含まれます。

 

フィールド名 message_info.post_delivery_info.interaction.attachment.file_extension_type
STRING
モード NULLABLE
説明 ファイル拡張子(MIME パートタイプではありません)。ピリオド(.)は含まれません

 

フィールド名 message_info.post_delivery_info.interaction.attachment.file_name
STRING
モード NULLABLE
説明 添付ファイル名

 

フィールド名 message_info.post_delivery_info.interaction.attachment.malware_family
INTEGER
モード NULLABLE
説明

マルウェアの種類(メールの処理中にマルウェアが検出された場合)。マルウェアが検出されていない場合、このフィールドは設定されません。 値は次のいずれかです。

1: 既知の不正プログラムが組み込まれているタイプのマルウェア

2: ウイルスやワームタイプのマルウェア

3: メールに有害なコンテンツが含まれている可能性あり

4: メールに望ましくないコンテンツが含まれている可能性あり

5: その他の種類のマルウェア

 

フィールド名 message_info.post_delivery_info.interaction.attachment.sha256
RECORD
モード NULLABLE
説明 添付ファイルの SHA256 ハッシュ

 

フィールド名 message_info.post_delivery_info.data_classification
RECORD
モード NULLABLE
説明 メールの分類に関する情報。message_info.post_delivery_info.action_type の値が 16 または 17 の場合に設定されます。

 

フィールド名 message_info.post_delivery_info.data_classification.classified_entity
INTEGER
モード NULLABLE
説明

分類されたエンティティの種類。 値は次のいずれかです。

1: メール本文

2: 添付ファイル

 

フィールド名 message_info.post_delivery_info.data_classification.event_type
INTEGER
モード NULLABLE
説明

分類イベントの種類。 値は次のいずれかです。

1: ラベルが変更されました

2: ラベルが新たに適用されました

3: ラベルを削除しました

 

フィールド名 message_info.post_delivery_info.data_classification.labels
RECORD
モード NULLABLE
説明 分類イベントが発生した後のエンティティの分類ラベル

 

フィールド名 message_info.post_delivery_info.data_classification.labels.field_value_display_name
STRING
モード NULLABLE
説明 ラベルの表示名

 

フィールド名 message_info.post_delivery_info.data_classification.previous_labels
RECORD
モード NULLABLE
説明 分類イベントが発生する前のエンティティの分類ラベル

 

フィールド名 message_info.post_delivery_info.data_classification.previous_labels.field_value_display_name
RECORD
モード NULLABLE
説明 以前のラベルの表示名

 

フィールド名 message_info.rfc2822_message_id
STRING
モード NULLABLE
説明 メールの RFC 2822 メール ID。この情報を確認するには、Gmail のメールで [メッセージのソースを表示] を選択します。

 

フィールド名 message_info.smime_content_type
INTEGER
モード NULLABLE
説明

Content-Type: ヘッダーで示される、メールの最上位 S/MIME タイプ。 値は次のいずれかです。

0: メールの S/MIME Content-Type を認識できません

1: 分離署名を含む S/MIME メッセージ。コンテンツ タイプ「multipart/signed」とパラメータ「protocol=application/pkcs7-signature」によって示されます

2: コンテンツ タイプ「application/pkcs7-mime」または「application/x-pkcs7-mime」とパラメータ「smime-type=signed-data」によって示される、不透明な署名を含む S/MIME メッセージ

3: コンテンツ タイプ「application/pkcs7-mime」または「application/x-pkcs7-mime」とパラメータ「smime-type=enveloped-data」によって示される、暗号化された S/MIME メッセージ

4: コンテンツ タイプ「application/pkcs7-mime」または「application/x-pkcs7-mime」とパラメータ「smime-type=compressed-data」によって示される、圧縮された S/MIME メッセージ

 

フィールド名 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: 1 日のレート制限を超えている

3: ピークレート制限を超えている

4: SMTP リレーの不正使用

5: ユーザーごとのレート制限を超えている

 

フィールド名 message_info.source
RECORD
モード NULLABLE
説明 送信者に関する情報

 

フィールド名 message_info.source.address
STRING
モード NULLABLE
説明 送信者のメールアドレス

 

フィールド名 message_info.source.from_header_address
STRING
モード NULLABLE
説明 メッセージ ヘッダーにある「From:」ヘッダー アドレス(例: johndoe@solarmora.comjohndoe@solarmora.com

 

フィールド名 message_info.source.from_header_displayname
STRING
モード NULLABLE
説明

メールヘッダーにある「From:」ヘッダー表示名(例: 「John Doe」)。ログが長すぎる場合、またはログ内のトリガーされたルール(triggered_rule_info)の数が多すぎる場合は、このフィールドの値の後半が省略されることがあります。

 

フィールド名 message_info.source.selector
STRING
モード NULLABLE
説明

送信元サーバーのサブカテゴリ。値の説明については、message_info.source.service をご覧ください。

 

フィールド名 message_info.source.service
STRING
モード NULLABLE
説明

メールの送信元サービス。次の 2 つのフィールドを使用して、メールの送信元となったサービスとメールが生成された理由を特定できます。

サービス

セレクタ

説明

カレンダー

送信

Google カレンダーからの通知

gmail-ui

read-receipt

Gmail の開封確認機能

gmail-ui

autoforward

Gmail の自動転送機能

gmail-ui

登録解除

Gmail の退会機能

gmail-ui

canned-response

Gmail の返信定型文機能によって送信されたメッセージ

gmail-ui

vacation-response

Gmail の不在通知機能

gmail-ui

送信

Gmail のウェブ UI から送信されたメール

docs

共有

Google ドライブからの共有通知

グループ

groups-ui

Google グループから送信されたメール

keep

件の招待

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

ユーザー

Google Apps Script から送信

mail-fetcher

null

Gmail Mail Fetcher によって取得されたメール

gmail-for-work

quarantine-delivery

Quarantine Manager からのメッセージ

gmail-for-work

quarantine-notification

検疫を受けて拒否されたメールの、元の送信者宛ての配信不能応答

gmail-for-work

ポリシー

ドメイン管理者による設定をトリガーしたメール

gmail-for-work

comprehensive-mail-storage

包括的なメール ストレージ設定により、Gmail のメールサーバーに送信

smtp-inbound

null

Google の SMTP サーバーから Gmail の配信パイプラインに挿入されたメール

smtp-msa

null

Google の SMTP サーバーから Gmail の配信パイプラインに、認証モードで挿入されたメール

smtp-rely リレー 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: 公開 RBL に掲載されているドメイン

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 Vault にアーカイブする

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: Vault での受信メール ジャーナルの受け入れ

20: 送信リレー

21: 検疫レポート

22: 安全な代替ルート

23: エイリアス表

24: 包括的なメール ストレージ

25: ルーティング ルール

26: 受信ゲートウェイ

27: S/MIME

28: サードパーティ製のメール アーカイブ ツール

 

フィールド名 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: 受信者ドメインの解決に関する DNS エラー
  • 3: 受信者のサーバーが接続を拒否
  • 4: 受信者の保存容量が不足

 

 

フィールド名 resource_details
フィールド タイプ REPEATED
説明 空、またはメッセージとメッセージに関連付けられたラベルを記述する 1 つの要素のみ

 

フィールド名 resource_details.id
フィールド タイプ STRING
説明 メールの RFC 2822 メール ID。メッセージにラベルが付いている場合にのみ設定します

 

フィールド名 resource_details.title
フィールド タイプ STRING
説明 メールの件名メッセージにラベルが付いている場合にのみ設定します

 

フィールド名 resource_details.type
フィールド タイプ STRING
説明 Gmail のイベントの場合は常にメールを送信します

 

フィールド名 resource_details.applied_labels
フィールド タイプ REPEATED
説明 メッセージに関連付けられているラベルを説明します

 

フィールド名 resource_details.applied_labels.id
フィールド タイプ STRING
説明 ラベル ID

 

フィールド名 resource_details.applied_labels.title
フィールド タイプ STRING
説明 ラベルのタイトル

 

フィールド名 resource_details.applied_labels.field_values
フィールド タイプ REPEATED
説明 ラベル フィールドの説明

 

フィールド名 resource_details.applied_labels.field_values.id
フィールド タイプ STRING
説明 フィールド ID

 

フィールド名 resource_details.applied_labels.field_values.display_name
フィールド タイプ STRING
説明 フィールド表示名

 

フィールド名 resource_details.applied_labels.field_values.type
フィールド タイプ STRING
説明 常に SELECTION(選択)。Gmail では現在、選択フィールドのみがサポートされているため

 

フィールド名 resource_details.applied_labels.field_values.selection_value
フィールド タイプ RECORD
説明 選択フィールドの選択

 

フィールド名 resource_details.applied_labels.field_values.selection_value.id
フィールド タイプ STRING
説明 選択 ID

 

フィールド名 resource_details.applied_labels.field_values.selection_value.display_name
フィールド タイプ STRING
説明 選択肢の表示名

 

フィールド名 resource_details.applied_labels.field_values.selection_value.badged
フィールド タイプ BOOLEAN
説明 選択肢にバッジが付いているかどうかを示します

この情報は役に立ちましたか?

改善できる点がありましたらお聞かせください。
検索
検索をクリア
検索を終了
Google アプリ
メインメニュー