Email Audit API की मदद से ईमेल की निगरानी करने के लिए, एडमिन एक तारीख की सीमा तय करता है. इससे ऑडिटर को किसी उपयोगकर्ता के भेजे और पाए गए ईमेल की कॉपी, अटैचमेंट के तौर पर मिलती है. हर दिन मॉनिटर बनाने और मिटाने के ज़्यादा से ज़्यादा 1,000 अनुरोध किए जा सकते हैं. यह सीमा हर डोमेन के लिए है. इसमें दिन भर में किसी भी एडमिन के किए गए सभी अनुरोध शामिल हैं.
निगरानी किए गए ईमेल के मामले में, तीन तरह के उपयोगकर्ता शामिल होते हैं:
एडमिन — डोमेन का कोई भी एडमिन, Email Audit API के मॉनिटर संसाधन का इस्तेमाल करके, ईमेल मॉनिटर बना सकता है, उसे वापस पा सकता है, अपडेट कर सकता है, और मिटा सकता है. इसके अलावा, एडमिन एपीआई का इस्तेमाल करके मेलबॉक्स डाउनलोड कर सकता है. ये कार्रवाइयां सिर्फ़ उस डोमेन में की जा सकती हैं जिस पर एडमिन का कंट्रोल होता है.
सोर्स उपयोगकर्ता — सोर्स उपयोगकर्ता वह व्यक्ति होता है जिसे निगरानी में रखे गए उपयोगकर्ता के ज़रिए ऑडिट किए जा रहे मैसेज मिलते या भेजे जाते हैं. कोई भी डोमेन एडमिन या खाता उपयोगकर्ता, सोर्स उपयोगकर्ता हो सकता है. सोर्स उपयोगकर्ता, एडमिन और डेस्टिनेशन उपयोगकर्ता के डोमेन में होना चाहिए.
डेस्टिनेशन उपयोगकर्ता — डेस्टिनेशन उपयोगकर्ता, ऑडिटर होता है. इसे ऑडिट किए गए ईमेल मिलते हैं.
- इस खाते को, आने वाले और भेजे जाने वाले सभी ईमेल की गुप्त कॉपी (बीसीसी) मिलती है. इनमें अटैचमेंट, फ़ॉरवर्ड किए गए मैसेज, और मोबाइल डिवाइसों से भेजे गए ईमेल शामिल हैं.
- इसके अलावा, डोमेन एडमिन, डेस्टिनेशन उपयोगकर्ता के लिए ऑडिटिंग की अतिरिक्त सुविधाएं चालू कर सकता है. ज़रूरी नहीं कि इन सुविधाओं का इस्तेमाल किया जाए. इनमें सेव किए गए ईमेल ड्राफ़्ट की ऑडिट करना और डोमेन के अंदर या बाहर के अन्य उपयोगकर्ताओं के साथ की गई संग्रहित Hangouts चैट की ऑडिट करना शामिल है.
- मैसेज पाने वाले उपयोगकर्ता को मैसेज की गुप्त कॉपी मिलती है. हालांकि, गुप्त कॉपी का जुड़ाव, मैसेज हेडर में नहीं दिखता. मैसेज हेडर, मैसेज भेजने वाले उपयोगकर्ता के खाते में ऐक्सेस किए जा सकते हैं.
- ऑडिट किए गए हर ईमेल मैसेज को, मंज़िल के तौर पर चुने गए उपयोगकर्ता को ईमेल अटैचमेंट के तौर पर भेजा जाता है. साथ ही, डोमेन एडमिन इन मैसेज को कॉन्फ़िगर कर सकता है. इसके लिए, वह पूरे ईमेल मैसेज या सिर्फ़ मैसेज हेडर का इस्तेमाल कर सकता है.
- गंतव्य उपयोगकर्ता के पास, मॉनिटर किए जा रहे डोमेन में चालू ईमेल खाता होना चाहिए. यह वही डोमेन होना चाहिए जो एडमिन और सोर्स उपयोगकर्ता से जुड़ा है.
- डेस्टिनेशन उपयोगकर्ता, डोमेन का एडमिन या उपयोगकर्ता हो सकता है. साथ ही, डेस्टिनेशन उपयोगकर्ता की भूमिका बदलकर सोर्स उपयोगकर्ता की भूमिका में बदला जा सकता है. इसकी ऑडिटिंग, डेस्टिनेशन उपयोगकर्ता की भूमिका वाले किसी दूसरे व्यक्ति के पास होती है. ऑडिटिंग करने वाले इस व्यक्ति को, ऑडिट किए गए सभी ईमेल मैसेज की कॉपी मिलती है. ये ईमेल मैसेज, डेस्टिनेशन उपयोगकर्ता की भूमिका वाले पहले व्यक्ति को भेजे जाते हैं.
- डोमेन एडमिन, 'डेस्टिनेशन उपयोगकर्ता - सोर्स उपयोगकर्ता' के एक यूनीक पेयर के लिए, ऑडिट किया गया एक ईमेल मॉनिटर बनाता है. दूसरे शब्दों में कहें, तो ऑडिट की सुविधा का इस्तेमाल करने के लिए, डेस्टिनेशन उपयोगकर्ता और सोर्स उपयोगकर्ता का अनुपात 1:1 होना चाहिए. हर ऑडिट, एपीआई मॉनिटर रिसॉर्स का इस्तेमाल करके किया जाता है. एक से ज़्यादा एपीआई मॉनिटर का इस्तेमाल करके, डेस्टिनेशन उपयोगकर्ता डोमेन में कई उपयोगकर्ताओं की ऑडिट कर सकता है. साथ ही, कई एपीआई मॉनिटर का इस्तेमाल करके, डेस्टिनेशन के कई उपयोगकर्ता, सोर्स के एक उपयोगकर्ता की ऑडिट कर सकते हैं.
- अगर 'डेस्टिनेशन उपयोगकर्ता - सोर्स उपयोगकर्ता' के पेयर के लिए कोई अतिरिक्त एपीआई मॉनिटर बनाया जाता है या किसी मौजूदा एपीआई मॉनिटर को अपडेट किया जाता है, तो इस पेयर के लिए, सबसे हाल ही में बनाया गया मॉनिटर, पहले से मौजूद किसी भी मॉनिटर की जगह ले लेता है. एपीआई मॉनिटर को इस तरह अपडेट किया जाता है. मॉनिटर को अपडेट करने के बारे में ज़्यादा जानकारी के लिए, ईमेल मॉनिटर अपडेट करना लेख पढ़ें.
ईमेल मॉनिटर बनाना
ईमेल मॉनिटर बनाने के लिए, ईमेल मॉनिटर संसाधन के साथ यह POST अनुरोध भेजें:
POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME
इनकी जगह ये डालें:
DOMAIN_NAME: Google Workspace डोमेन का नाम—उदाहरण के लिए, example.com.SOURCE_USERNAME: वह उपयोगकर्ता नाम जिसे आपको मॉनिटर करना है.
POST अनुरोध में यह Content-type हेडर शामिल है:
Content-type: application/atom+xml
ईमेल मॉनिटर करने के अनुरोध में इस्तेमाल किए जाने वाले पैरामीटर की पूरी सूची देखने के लिए, संसाधन: monitor पर जाएं.
नया मॉनिटर बनाने का उदाहरण
इस उदाहरण में, इन पैरामीटर का इस्तेमाल किया गया है:
- जिस उपयोगकर्ता के खाते की ऑडिट की जानी है वह
amal@example.comहै. destUserName,izumiहै.beginDate,June 15, 2022, 00:00 hoursहै.endDate,June 30, 2022, 23:20 hoursहै.incomingEmailMonitorLevel,FULL_MESSAGEहै.outgoingEmailMonitorLevel,HEADER_ONLYहै.draftMonitorLevel,FULL_MESSAGEहै.chatMonitorLevel,FULL_MESSAGEहै.
प्रोटोकॉल
POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal <atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'> <apps:property name='destUserName' value='izumi'/> <apps:property name='beginDate' value='2022-06-15 00:00'/> <apps:property name='endDate' value='2022-06-30 23:20'/> <apps:property name='incomingEmailMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='outgoingEmailMonitorLevel' value='HEADER_ONLY'/> <apps:property name='draftMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='chatMonitorLevel' value='FULL_MESSAGE'/> </atom:entry>
अगर अनुरोध पूरा हो जाता है, तो सर्वर 201 CREATED स्टेटस कोड और AtomPub एंट्री दिखाता है. इसमें entry एलिमेंट में मॉनिटर की नई सेटिंग दिखती हैं:
<entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'> <id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/id</id> <updated>2022-04-17T15:02:45.646Z</updated/> <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/id'/> <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/id'/> <apps:property name='destUserName' value='izumi'/> <apps:property name='beginDate' value='2022-06-15 00:00'/> <apps:property name='endDate' value='2022-06-30 23:20'/> <apps:property name='incomingEmailMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='outgoingEmailMonitorLevel' value='HEADER_ONLY'/> <apps:property name='draftMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='chatMonitorLevel' value='FULL_MESSAGE'/> </entry>
Java
import java.util.Calendar; import com.google.gdata.client.appsforyourdomain.audit.AuditService; import com.google.gdata.data.appsforyourdomain.generic.GenericEntry; import com.google.gdata.client.appsforyourdomain.audit.MailMonitor; ... MailMonitor monitor = new MailMonitor(); Calendar beginDate = Calendar.getInstance(); beginDate.set(2022, Calendar.JUNE, 15, 0, 0) monitor.setBeginDate(beginDate.getTime()); Calendar endDate = Calendar.getInstance(); endDate.set(2022, Calendar.JUNE, 30, 23, 20); monitor.setEndDate(endDate.getTime()); monitor.setIncomingEmailMonitorLevel("FULL_MESSAGE"); monitor.setOutgoingEmailMonitorLevel("HEADER_ONLY"); monitor.setDraftMonitorLevel("FULL_MESSAGE"); monitor.setChatMonitorLevel("FULL_MESSAGE"); monitor.setDestUserName("izumi"); AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); GenericEntry entry = service.createMailMonitor("amal", monitor);
.NET
using System; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... MailMonitor monitor = new MailMonitor(); monitor.BeginDate = new DateTime(2022, 6, 15); monitor.EndDate = new DateTime(2022, 6, 30, 23, 20, 0); monitor.IncomingEmailMonitorLevel = MonitorLevel.FULL_MESSAGE; monitor.OutgoingEmailMonitorLevel = MonitorLevel.HEADER_ONLY; monitor.DraftMonitorLevel = MonitorLevel.FULL_MESSAGE; monitor.ChatMonitorLevel = MonitorLevel.FULL_MESSAGE; monitor.DestinationUserName = "izumi"; AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); MailMonitor monitorEntry = service.CreateMailMonitor("amal", monitor);
ईमेल मॉनिटर अपडेट करना
जब एक ही सोर्स उपयोगकर्ता और डेस्टिनेशन उपयोगकर्ता के लिए मॉनिटर को अपडेट किया जाता है, तो मॉनिटर की शुरुआती प्रॉपर्टी सेटिंग, नई सेटिंग से बदल जाती हैं.
ईमेल मॉनिटर में ऑडिट कॉन्फ़िगरेशन अपडेट करने के लिए, मॉनिटर फ़ीड के यूआरआई को POST अनुरोध भेजें और Authorization हेडर शामिल करें:
POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME
इनकी जगह ये डालें:
DOMAIN_NAME: Google Workspace डोमेन का नाम—उदाहरण के लिए, example.com.SOURCE_USERNAME: वह ईमेल मॉनिटर जिसका उपयोगकर्ता नाम आपको अपडेट करना है.
ईमेल मॉनिटर को अपडेट करने का उदाहरण
इस उदाहरण में, ईमेल मॉनिटर बनाने के उदाहरण में बनाए गए मॉनिटर को अपडेट किया गया है. इसके लिए, ज़रूरी प्रॉपर्टी endDate और वैकल्पिक प्रॉपर्टी chatMonitorLevel को अपडेट किया गया है. इस उदाहरण में, इन पैरामीटर का इस्तेमाल किया गया है:
- नया
endDateAugust 30, 2022, 23:20 hoursहै. chatMonitorLevelअबHEADER_ONLYहै.- जिस उपयोगकर्ता की ऑडिट की जानी है वह
amal@example.comबना रहता है. destUserName,izumiही रहेगा.
जिन मॉनिटर प्रॉपर्टी को अपडेट नहीं किया गया है वे अपनी डिफ़ॉल्ट वैल्यू पर वापस सेट हो जाती हैं. उदाहरण के लिए, इस उदाहरण में incomingEmailMonitorLevel और outgoingEmailMonitorLevel प्रॉपर्टी FULL_MESSAGE पर वापस आ जाती हैं. साथ ही, draftMonitorLevel प्रॉपर्टी NONE पर वापस आ जाती है.
प्रोटोकॉल
POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal
<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
<apps:property name='destUserName' value='izumi'/>
<apps:property name='endDate' value='2022-08-30 23:20'/>
<apps:property name='chatMonitorLevel' value='HEADER_ONLY'/>
</atom:entry>अगर यह अनुरोध पूरा हो जाता है, तो सर्वर 201 CREATED स्टेटस कोड दिखाता है. साथ ही, अपडेट किए गए entry एलिमेंट के साथ एक AtomPub एंट्री दिखाता है. जिन प्रॉपर्टी को अपडेट नहीं किया गया है और जवाब में दिखाया गया है वे अपनी डिफ़ॉल्ट वैल्यू पर वापस आ जाती हैं.
<entry> <entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'> <id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/izumi</id> <updated>2022-08-20T00:28:57.319Z</updated> <link rel='self' type='application/atom+xml' href="https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/izumi" /> <link rel='edit' type='application/atom+xml' href="https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/izumi" /> <apps:property name='chatMonitorLevel' value='HEADER_ONLY' /> <apps:property name='destUserName' value='izumi' /> <apps:property name='endDate' value='2022-08-30 23:20' /> </entry>
Java
import java.util.Calendar; import com.google.gdata.client.appsforyourdomain.audit.AuditService; import com.google.gdata.client.appsforyourdomain.audit.MailMonitor; import com.google.gdata.data.appsforyourdomain.generic.GenericEntry; ... MailMonitor monitor = new MailMonitor(); Calendar endDate = Calendar.getInstance(); endDate.set(2022, Calendar.AUGUST, 30, 23, 20); monitor.setEndDate(endDate.getTime()); monitor.setChatMonitorLevel("HEADER_ONLY"); monitor.setDestUserName("izumi"); AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); GenericEntry entry = service.createMailMonitor("amal", monitor);
.NET
using System; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... MailMonitor monitor = new MailMonitor(); monitor.EndDate = new DateTime(2022, 8, 30, 23, 20, 0); monitor.ChatMonitorLevel = MonitorLevel.HEADER_ONLY; monitor.DestinationUserName = "izumi"; AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); MailMonitor monitorEntry = service.CreateMailMonitor("amal", monitor);
सोर्स उपयोगकर्ता के सभी ईमेल मॉनिटर वापस पाएं
सोर्स उपयोगकर्ता से जुड़ी सभी मॉनिटरिंग की जानकारी पाने के लिए, मॉनिटर फ़ीड यूआरआई को एचटीटीपी GET अनुरोध भेजें. इसके लिए, तारीख के लिए यूटीसी फ़ॉर्मैट का इस्तेमाल करें. साथ ही, Authorization हेडर शामिल करें:
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME
इनकी जगह ये डालें:
DOMAIN_NAME: Google Workspace डोमेन का नाम—उदाहरण के लिए, example.com.SOURCE_USERNAME: वह ईमेल मॉनिटर जिसका उपयोगकर्ता नाम आपको वापस पाना है.
इस ऑपरेशन के लिए, अनुरोध के मुख्य हिस्से में कोई पैरामीटर नहीं है. इसलिए, एक्सएमएल का मुख्य हिस्सा खाली है.
सभी ईमेल मॉनिटर वापस पाने का उदाहरण
इस उदाहरण में, उपयोगकर्ता amal@example.com के लिए बनाई गई सभी मॉनिटरिंग की जानकारी मिलती है:
प्रोटोकॉल
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal
अगर अनुरोध पूरा हो जाता है, तो सर्वर 201 CREATED स्टेटस कोड दिखाता है. साथ ही, AtomPub फ़ीड दिखाता है. इसमें दो मॉनिटर के लिए entry एलिमेंट होते हैं. ये एलिमेंट, दो डेस्टिनेशन उपयोगकर्ताओं (izumi@example.com,
taylor@example.com) के लिए सेटिंग दिखाते हैं.
<feed xmlns:atom='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006'> <id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal</id> <updated>2010-03-17T15:29:21.064Z</updated> <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal'/> <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal'/> <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal'/> <openSearch:startIndex>1</openSearch:startIndex> <entry> <id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/izumi</id> <updated>2022-04-17T15:29:21.064Z</updated> <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/izumi&'/> <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/feeds/compliance/audit/mail/monitor/example.com/amal/izumi&'/> <apps:property name='requestId' value='53156'/> <apps:property name='destUserName' value='izumi'/> <apps:property name='beginDate' value='2022-06-15 00:00'/> <apps:property name='endDate' value='2022-06-30 23:20'/> <apps:property name='incomingEmailMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='outgoingEmailMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='draftMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='chatMonitorLevel' value='FULL_MESSAGE'/> </entry> <entry> <id>>https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/taylor</id> <updated>2022-05-17T15:29:21.064Z</updated> <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/taylor'/> <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/taylor'/> <apps:property name='requestId' value='22405'/> <apps:property name='destUserName' value='taylor'/> <apps:property name='beginDate' value='2022-06-20 00:00'/> <apps:property name='endDate' value='2022-07-30 23:20'/> <apps:property name='incomingEmailMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='outgoingEmailMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='draftMonitorLevel' value='FULL_MESSAGE'/> <apps:property name='chatMonitorLevel' value='FULL_MESSAGE'/> </entry> </feed>
Java
import com.google.gdata.client.appsforyourdomain.audit.AuditService; import com.google.gdata.data.appsforyourdomain.generic.GenericFeed; ... AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); GenericFeed feed = service.retrieveMonitors("amal");
.NET
using System; using System.Collections.Generic; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); GenericFeed<MailMonitor> monitors = service.RetrieveMailMonitors("amal");
ईमेल मॉनिटर मिटाना
ईमेल मॉनिटर मिटाने के लिए, मॉनिटर फ़ीड के मिटाने वाले यूआरआई को एचटीटीपी DELETE अनुरोध भेजें और Authorization हेडर शामिल करें:
DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME/DESTINATION_USERNAME
इनकी जगह ये डालें:
DOMAIN_NAME: Google Workspace डोमेन का नाम—उदाहरण के लिए, example.com.SOURCE_USERNAME: वह ईमेल मॉनिटर जिसका उपयोगकर्ता नाम आपको मिटाना है.DESTINATION_USERNAME: ऑडिट करने वाला व्यक्ति, जिसे ऑडिट किए गए ईमेल मिलते हैं.
ईमेल मॉनिटर मिटाने का उदाहरण
इस उदाहरण में, amal@example.com उपयोगकर्ता के लिए बनाई गई मॉनिटर मिटाई गई हैं. इसमें destinationUserName को izumi के तौर पर इस्तेमाल किया गया है.
प्रोटोकॉल
DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/izumi
Java
import com.google.gdata.client.appsforyourdomain.audit.AuditService; ... AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1"); service.deleteMonitor("amal", "izumi");
.NET
using System; using Google.GData.Apps; using Google.GData.Extensions.Apps; ... AuditService service = new AuditService("example.com", "example.com-auditapp-v1"); service.setUserCredentials("admin@example.com", "p@55w0rd"); service.DeleteMailMonitor("amal", "izumi");