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 (整数)

    ログに記録されたイベントの種類。Gmail の監査ログの場合、eventName は常に定数(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: 1 つ以上のメール添付ファイルがプレビューされた
    • 29: メッセージが下書きとして保存された
    • 30: メールは送信できず、返送された
    • 31: メッセージが表示された(初回とそれ以降の閲覧を含む)。iOS の既知の問題について詳しくは、Google Workspace の既知の問題をご覧ください。
    • 32: メッセージがダウンロードされた
    • 33: ユーザーに代わってアプリケーションがメッセージにアクセスした
    • 34: 受信レートが制限された - 受信レートの上限(DoS)により、メッセージが拒否またはスロットリングされた
    • 35: ユーザーまたは API によってメール送信プロセスが開始された

リクエストの例
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