> ## 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 रिपोर्टिंग सिमुलेशन इवेंट्स और एंटिटीज़ से पिछले प्रदाता के इवेंट-स्तरीय फ़िशिंग लॉग को पुनः तैयार करें।

यह रिपोर्ट इवेंट-स्तरीय फ़िशिंग लॉग है: प्रत्येक देखे गए सिमुलेशन इंटरैक्शन (date, action, recipient email, subject, from, difficulty) के लिए एक पंक्ति। यह लॉन्ग-फ़ॉर्म में ही रहती है — यह किसी व्यक्ति के इतिहास को एक ही परिणाम में संक्षिप्त नहीं करती।

क्वेरी पिछले **12 कैलेंडर महीनों** को `occurred_after` में समेटती है
(बारह महीने पहले उसी तारीख़ की मध्यरात्रि UTC — 365 दिनों की अवधि नहीं)।

<Note>
  रॉ क्लाइंट IP कभी भी `/v1` पर उपलब्ध नहीं होता — यह प्राइवेसी बाय डिज़ाइन है, लंबित मैपिंग नहीं। डिवाइस टाइप इवेंट पंक्ति पर एक व्युत्पन्न क्लास है; रॉ
  `user_agent` निजी रहता है। देखें
  [Divergences from the legacy export](#legacy-%E0%A4%8F%E0%A4%95%E0%A5%8D%E0%A4%B8%E0%A4%AA%E0%A5%8B%E0%A4%B0%E0%A5%8D%E0%A4%9F-%E0%A4%B8%E0%A5%87-%E0%A4%85%E0%A4%82%E0%A4%A4%E0%A4%B0)।
</Note>

सेटअप, क्रेडेंशियल, पेजिनेशन और रेट-लिमिट रीट्राई [Power BI / Excel connectivity guide](/hi/developers/v1/powerbi) के समान हैं। पहले साझा `Fn_FetchAll` क्वेरी जोड़ें; यह रिपोर्ट उसे नाम से कॉल करती है।

## आवश्यक की स्कोप

| Scope | उपयोग |
| - | - |
| `reporting:read` | `GET /v1/reporting/simulation_events` |
| `entity:read` | `GET /v1/entities` (ईमेल और डिस्प्ले नाम का जॉइन) |

केवल `simulation:read` प्राप्त की रिपोर्टिंग इवेंट्स एंडपॉइंट को कॉल नहीं कर सकती (API `403` लौटाता है)। देखें
[choose the right grain](/hi/developers/v1/powerbi#%E0%A4%B8%E0%A4%B9%E0%A5%80-grain-%E0%A4%9A%E0%A5%81%E0%A4%A8%E0%A5%87%E0%A4%82)।

## स्रोत एंडपॉइंट

| एंडपॉइंट | भूमिका |
| - | - |
| `GET /v1/reporting/simulation_events` | इवेंट-स्तरीय फ़ैक्ट। ग्रेन एक टाइप्ड इंटरैक्शन है। `email_subject`, `sender_email`, `sender_domain` और `difficulty_tier` इसी पंक्ति पर होते हैं, इसलिए क्वेरी इन फ़ील्ड्स के लिए कैंपेन-स्तरीय परिणामों को जॉइन नहीं करती। |
| `GET /v1/entities` | `entity_id` → ईमेल / डिस्प्ले नाम में रिज़ॉल्व करता है। रिपोर्टिंग इवेंट में प्राप्तकर्ता का ईमेल शामिल नहीं होता (रिपोर्टिंग रीडर पर यह कठोर अपवर्जन है)। `/entities` को वॉक करके ही पारंपरिक "email" कॉलम भरा जाता है। |

इवेंट्स लिस्ट पर अनुमत फ़िल्टर (इनके अलावा कुछ भी `400` लौटाता है):
`limit`, `page_token`, `simulation`, `entity`, `event_type`,
`occurred_after`।

यह रिपोर्टिंग फ़ैमिली एक [preview dataset](/hi/developers/v1/powerbi#reporting-preview-datasets-%E0%A4%AA%E0%A5%8D%E0%A4%B0%E0%A4%A4%E0%A4%BF-%E0%A4%B5%E0%A5%8D%E0%A4%AF%E0%A4%95%E0%A5%8D%E0%A4%A4%E0%A4%BF-phishing) है।
डेटासेट स्कीमा और डेटा नीतियों को
`GET /v1/reporting/datasets` और
`GET /v1/reporting/datasets/simulation_events` पर देखें।

### ग्रेन

प्रत्येक रिपोर्टिंग सिमुलेशन इवेंट के लिए एक पंक्ति। जिस व्यक्ति ने एक ही संदेश को खोला और फिर उस पर क्लिक किया, उसके लिए दो पंक्तियाँ बनती हैं। जिन इवेंट्स में `entity_id` null है
(कोई एक्टर / प्राप्तकर्ता / लक्षित प्रतिभागी नहीं) वे भी दिखाई देते हैं — `email` null होता है।

API विंडो को एक मिनट बढ़ाया जाता है; सटीक
`occurred_at >= WindowStart` सीमा को स्थानीय रूप से पुनः लागू किया जाता है, ताकि पिछला वर्ष इस बात पर निर्भर न करे कि सर्वर `occurred_after` को
समावेशी मानता है या अपवर्जी।

रिक्वेस्ट बजट: विंडो में इवेंट्स का एक पेजिनेटेड वॉक, और एंटिटीज़ का एक वॉक। हमेशा `limit = "500"` सेट करें।

## कॉलम मैपिंग

Legacy कॉलम नाम आपके पिछले प्रदाता के एक्सपोर्ट से हैं। `/v1` फ़ील्ड्स
सार्वजनिक API नाम हैं; क्वेरी रिपोर्ट के लिए इनमें से कुछ को ऐलियस करती है।

| Legacy कॉलम | `/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 टोकन

`action` क्लोज़्ड रिपोर्टिंग टोकन है। Legacy "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`।

## Legacy एक्सपोर्ट से अंतर

* **रॉ IP कभी उपलब्ध नहीं होता।** `/v1` रॉ क्लाइंट IP को उजागर नहीं करेगा —
  यह प्राइवेसी बाय डिज़ाइन है, लंबित मैपिंग नहीं। क्वेरी कोई प्लेसहोल्डर IP कॉलम नहीं जोड़ती।
* **डिवाइस टाइप व्युत्पन्न है, रॉ नहीं।** `device_type` क्लिक, सबमिट और रिपोर्ट इवेंट्स के लिए एक व्युत्पन्न डिवाइस क्लास है। देखे गए टोकन में
  `desktop`, `mobile`, `tablet` और `unknown` शामिल हैं, लेकिन एमिटर एक फ़्री-फ़ॉर्म स्ट्रिंग संग्रहीत करता है — इसे ओपन टेक्स्ट मानें, क्लोज़्ड enum नहीं। जब इवेंट में कोई व्युत्पन्न क्लास नहीं होती तो यह null होता है, और रॉ `user_agent` स्ट्रिंग
  निजी रहती है।
* **"Email Sent" `simulation.delivered` है।** भेजे गए ईमेल को फ़िल्टर या गिनते समय इसी टोकन का उपयोग करें। Legacy `email_sent` स्ट्रिंग न खोजें।
* **प्राप्तकर्ता का ईमेल जॉइन है, इवेंट पर फ़ील्ड नहीं।** रिपोर्टिंग इवेंट में ईमेल शामिल नहीं होता; क्वेरी इसे भरने के लिए `/entities` को वॉक करती है।
* **पिछले 12 कैलेंडर महीने**, 365 दिनों की अवधि नहीं, और पूरा इतिहास भी नहीं।
* **लॉन्ग-फ़ॉर्म, संक्षिप्त नहीं।** प्रति इंटरैक्शन एक पंक्ति, प्रति व्यक्ति एक परिणाम नहीं।

## अगले चरण

<CardGroup cols={2}>
  <Card title="Power BI और Excel सेटअप" href="/hi/developers/v1/powerbi">
    क्रेडेंशियल, पेजिनेशन, और Power BI या Excel में इन क्वेरीज़ को लोड करना।
  </Card>

  <Card title="सबसे अधिक संवेदनशील उपयोगकर्ता" href="/hi/developers/v1/reports/most-susceptible-users">
    प्रति-व्यक्ति 12 महीने का क्लिक, क्रेडेंशियल और रिपोर्ट रोलअप।
  </Card>

  <Card title="प्रति-व्यक्ति अनुपालन" href="/hi/developers/v1/reports/per-person-compliance">
    व्यक्ति × असाइनमेंट ग्रेन पर Training नामांकन।
  </Card>

  <Card title="API कीज़" href="/hi/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.