> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# メールフィッシングログ

> /v1 のレポーティング用シミュレーションイベントとエンティティから、以前のプロバイダーのイベントレベルのフィッシングログを再現します。

このレポートは、イベントレベルのフィッシングログです。観測されたシミュレーション上のやり取りごとに 1 行(日付、アクション、受信者のメールアドレス、件名、送信元、難易度)が出力されます。ロングフォーム形式のままであり、個人の履歴を 1 つの結果にまとめることはありません。

このクエリは、直近 **12 暦月** を `occurred_after` に畳み込みます(12 か月前の同じ日の UTC 午前 0 時を起点とし、365 日間の期間ではありません)。

<Note>
  クライアントの生の IP は `/v1` には一切含まれません。これはプライバシーバイデザインによるものであり、マッピングが保留されているわけではありません。デバイスタイプはイベント行上の派生クラスであり、生の `user_agent` は非公開のままです。詳細は、[従来のエクスポートとの相違点](#%E5%BE%93%E6%9D%A5%E3%81%AE%E3%82%A8%E3%82%AF%E3%82%B9%E3%83%9D%E3%83%BC%E3%83%88%E3%81%A8%E3%81%AE%E7%9B%B8%E9%81%95%E7%82%B9)をご覧ください。
</Note>

セットアップ、認証情報、ページネーション、およびレート制限時の再試行は、[Power BI / Excel 接続ガイド](/ja/developers/v1/powerbi)と同じです。最初に共有の `Fn_FetchAll` クエリを追加してください。このレポートは、そのクエリを名前で呼び出します。

## 必要なキースコープ

| スコープ | 用途 |
| - | - |
| `reporting:read` | `GET /v1/reporting/simulation_events` |
| `entity:read` | `GET /v1/entities`(メールアドレスと表示名の結合) |

`simulation:read` のみが付与されたキーでは、レポーティングイベントのエンドポイントを呼び出せません(API は `403` を返します)。[適切なグレインの選択](/ja/developers/v1/powerbi#%E9%81%A9%E5%88%87%E3%81%AA%E7%B2%92%E5%BA%A6%E3%81%AE%E9%81%B8%E6%8A%9E)をご覧ください。

## ソースエンドポイント

| エンドポイント | 役割 |
| - | - |
| `GET /v1/reporting/simulation_events` | イベントレベルのファクトです。グレインは、種別が指定された 1 回のやり取りです。`email_subject`、`sender_email`、`sender_domain`、`difficulty_tier` はこの行に含まれるため、クエリはこれらのフィールドのためにキャンペーンレベルの結果を結合しません。 |
| `GET /v1/entities` | `entity_id` をメールアドレス/表示名に解決します。レポーティングイベントには受信者のメールアドレスが含まれません(レポーティングリーダーでの厳格な除外)。従来の「email」列は、`/entities` をたどることで設定されます。 |

イベント一覧で許可されているフィルター(これ以外は `400` を返します):
`limit`、`page_token`、`simulation`、`entity`、`event_type`、
`occurred_after`。

このレポーティングファミリーは[プレビューデータセット](/ja/developers/v1/powerbi#%E3%83%AC%E3%83%9D%E3%83%BC%E3%83%88%E3%83%97%E3%83%AC%E3%83%93%E3%83%A5%E3%83%BC%E3%83%87%E3%83%BC%E3%82%BF%E3%82%BB%E3%83%83%E3%83%88-%E5%80%8B%E4%BA%BA%E5%8D%98%E4%BD%8D%E3%81%AE%E3%83%95%E3%82%A3%E3%83%83%E3%82%B7%E3%83%B3%E3%82%B0)です。データセットのスキーマとデータポリシーは、`GET /v1/reporting/datasets` および `GET /v1/reporting/datasets/simulation_events` で確認できます。

### グレイン

レポーティング用シミュレーションイベントごとに 1 行です。同じメッセージを開封し、その後クリックした人は 2 行になります。`entity_id` が null のイベント(アクター/受信者/対象参加者なし)も表示されます。この場合、`email` は null です。

API のウィンドウは 1 分間広げられます。正確な `occurred_at >= WindowStart` の境界はローカルで再適用されるため、直近 1 年間は、サーバーが `occurred_after` を包含的に扱うか排他的に扱うかに依存しません。

リクエスト予算:ウィンドウ内のイベントのページネーション付き走査 1 回と、エンティティの走査 1 回です。必ず `limit = "500"` を設定してください。

## 列のマッピング

従来の列名は、以前のプロバイダーのエクスポートに基づきます。`/v1` のフィールドは公開 API 名であり、クエリではレポート用にその一部へ別名を付けています。

| 従来の列 | `/v1` のフィールドまたは導出 | レポート列 |
| - | - | - |
| Date | `Event.occurred_at`(日付として。生の `occurred_at` は `datetimezone` として保持されます) | `date` |
| Action | `Event.event_type` — 固定トークンは以下に記載 | `action` |
| Email | `Entity.email`(`entity_id` で結合) | `email` |
| Subject | `Event.email_subject` | `subject` |
| From | `Event.sender_email` | `from` |
| Difficulty | `Event.difficulty_tier` — 1〜5 の整数(1 が最も易しく、5 が最も難しい) | `difficulty` |
| Raw IP | `/v1` には一切含まれません | 省略されます(null にはなりません) |
| Device type | `Event.device_type` — 派生クラス。イベントに派生クラスがない場合は null | `device_type` |

### アクショントークン

`action` は、レポーティング用の固定トークンです。従来の「Email Sent」は `simulation.delivered` に対応します(`delivered` は公開動詞で、ワイヤートークンは `simulation.delivered` です)。

| `action` の値 |
| - |
| `simulation.delivered` |
| `simulation.opened` |
| `simulation.link_clicked` |
| `simulation.credentials_submitted` |
| `simulation.attachment_opened` |
| `simulation.reported` |
| `simulation.bounced` |
| `simulation.qr_scanned` |
| `simulation.replied` |

API に存在するため保持される追加フィールド:`sender_domain`、`full_name`、`event_id`、`entity_id`、`simulation_id`、`occurred_at`、およびエンティティ結合による `entity_type` と `entity_status`。

## 従来のエクスポートとの相違点

* **生の IP は利用できません。** `/v1` は、クライアントの生の IP を公開しません。これはプライバシーバイデザインによるものであり、マッピングが保留されているわけではありません。クエリは、プレースホルダーの IP 列を追加しません。
* **デバイスタイプは生の値ではなく派生値です。** `device_type` は、クリック、送信、報告イベントに対する派生デバイスクラスです。観測されるトークンには `desktop`、`mobile`、`tablet`、`unknown` がありますが、エミッターは自由形式の文字列を保存するため、固定の列挙型ではなくオープンテキストとして扱ってください。イベントに派生クラスがない場合は null となり、生の `user_agent` 文字列は非公開のままです。
* **「Email Sent」は `simulation.delivered` です。** 送信をフィルターまたは集計する際は、このトークンを使用してください。従来の `email_sent` 文字列を探さないでください。
* **受信者のメールアドレスは、イベントのフィールドではなく結合で取得します。** レポーティングイベントにはメールアドレスが含まれないため、クエリは `/entities` をたどって補完します。
* **直近 12 暦月**であり、365 日間の期間でも全履歴でもありません。
* **ロングフォームであり、集約されません。** 1 人につき 1 つの結果ではなく、やり取りごとに 1 行です。

## 次のステップ

<CardGroup cols={2}>
  <Card title="Power BI と Excel のセットアップ" href="/ja/developers/v1/powerbi">
    認証情報、ページネーション、および Power BI や Excel でのこれらのクエリの読み込み。
  </Card>

  <Card title="最も影響を受けやすいユーザー" href="/ja/developers/v1/reports/most-susceptible-users">
    個人単位の 12 か月間のクリック、認証情報、報告の集計。
  </Card>

  <Card title="個人別コンプライアンス" href="/ja/developers/v1/reports/per-person-compliance">
    個人 × 割り当て単位のトレーニング登録。
  </Card>

  <Card title="API キー" href="/ja/developers/developer-hub/api-keys">
    このレポートを更新するキーに `reporting:read` と `entity:read` を付与します。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.