ईमेल ऑडिट एपीआई की मदद से ईमेल मॉनिटर करने की सुविधा सेट अप करने के लिए, एडमिन ऑडिटर के लिए एक तारीख की सीमा सेट करता है, ताकि उसे किसी उपयोगकर्ता के भेजे गए और मिले ईमेल की कॉपी को अटैचमेंट के तौर पर मिल सके. मॉनिटर बनाने और मिटाने के हर दिन, ज़्यादा से ज़्यादा 1,000 अनुरोध भेजे जा सकते हैं. यह सीमा प्रति डोमेन है और इसमें किसी भी एडमिन की ओर से दिन के दौरान किए गए सभी अनुरोध शामिल हैं.
निगरानी वाले ईमेल की स्थिति में तीन तरह के उपयोगकर्ता शामिल होते हैं:
एडमिन — कोई भी डोमेन एडमिन, ईमेल ऑडिट एपीआई के मॉनिटर संसाधन का इस्तेमाल करके ईमेल मॉनिटर बना सकता है, उसे वापस पा सकता है, अपडेट कर सकता है, और मिटा सकता है. इसके अलावा, एडमिन मेलबॉक्स को डाउनलोड करने के लिए, एपीआई का इस्तेमाल कर सकता है. ये कार्रवाई सिर्फ़ उस डोमेन में की जा सकती हैं जिस पर एडमिन कंट्रोल करता है.
सोर्स उपयोगकर्ता — सोर्स उपयोगकर्ता वह उपयोगकर्ता होता है जो ऐसे मैसेज पाने या भेजता है जिनका ऑडिट, मॉनिटरिंग डेस्टिनेशन के उपयोगकर्ता करता है. डोमेन का कोई भी एडमिन या खाता उपयोगकर्ता सोर्स उपयोगकर्ता हो सकता है. सोर्स उपयोगकर्ता, एडमिन और डेस्टिनेशन उपयोगकर्ता वाले डोमेन में होना चाहिए.
डेस्टिनेशन उपयोगकर्ता — डेस्टिनेशन उपयोगकर्ता वह ऑडिटर है जिसे ऑडिट किए गए ईमेल मैसेज मिलते हैं.
- इनकमिंग और आउटगोइंग ईमेल मैसेज की ब्लाइंड कार्बन कॉपी (गुप्त कॉपी) मिलती है. इसमें इनबाउंड और आउटबाउंड अटैचमेंट, फ़ॉरवर्ड किए गए मैसेज, और मोबाइल डिवाइस से भेजे गए ईमेल मैसेज शामिल हैं.
- विकल्प के तौर पर, डोमेन एडमिन डेस्टिनेशन उपयोगकर्ता के लिए ऑडिटिंग की अतिरिक्त सुविधाएं चालू कर सकता है. वैकल्पिक सुविधाओं में सेव किए गए ईमेल के ड्राफ़्ट की जांच करना और संग्रहित किए गए Hangouts की चैट का ऑडिट करना शामिल है. यह उन उपयोगकर्ताओं के साथ होता है जो डोमेन के अंदर या बाहर हो सकते हैं.
- डेस्टिनेशन उपयोगकर्ता को मैसेज की गुप्त कॉपी मिलती है, लेकिन सोर्स उपयोगकर्ता के खाते में ऐक्सेस किए जा सकने वाले मैसेज हेडर में वह गुप्त कॉपी नहीं दिखेगा.
- ऑडिट किए गए हर ईमेल मैसेज को, डेस्टिनेशन उपयोगकर्ता को ईमेल अटैचमेंट के तौर पर भेजा जाता है. डोमेन एडमिन इन मैसेज को या तो पूरे ईमेल मैसेज या सिर्फ़ मैसेज के हेडर के तौर पर कॉन्फ़िगर कर सकता है.
- इस डेस्टिनेशन उपयोगकर्ता के पास निगरानी वाले डोमेन में, एक चालू ईमेल खाता होना चाहिए. यह वही डोमेन होना चाहिए जो एडमिन और सोर्स उपयोगकर्ता से जुड़ा है.
- डेस्टिनेशन उपयोगकर्ता, एडमिन या डोमेन का उपयोगकर्ता हो सकता है. साथ ही, यह डेस्टिनेशन उपयोगकर्ता किसी दूसरे डेस्टिनेशन उपयोगकर्ता से ऑडिट किए गए सोर्स उपयोगकर्ता बनने के लिए भूमिकाएं बदल सकता है. इस उपयोगकर्ता को, ऑडिट किए गए सभी ईमेल मैसेज की कॉपी मिलती हैं. ये मैसेज उस उपयोगकर्ता को भेजे जाते हैं जो पहले डेस्टिनेशन उपयोगकर्ता को भेजा गया था.
- कोई डोमेन एडमिन, यूनीक 'डेस्टिनेशन उपयोगकर्ता - सोर्स उपयोगकर्ता' जोड़े के लिए, ऑडिट किया गया एक ईमेल मॉनिटर बनाता है. दूसरे शब्दों में, ऑडिट संबंध एक स्रोत उपयोगकर्ता के लिए एक डेस्टिनेशन उपयोगकर्ता होता है. हर ऑडिट एक एपीआई मॉनिटर संसाधन का इस्तेमाल करके किया जाता है. एक से ज़्यादा एपीआई मॉनिटर का इस्तेमाल करके, डेस्टिनेशन उपयोगकर्ता, डोमेन के कई उपयोगकर्ताओं को ऑडिट कर सकता है. साथ ही, एक से ज़्यादा एपीआई मॉनिटर का इस्तेमाल करके, कई डेस्टिनेशन उपयोगकर्ता एक ही सोर्स उपयोगकर्ता को ऑडिट कर सकते हैं.
- अगर एक अतिरिक्त एपीआई मॉनिटर बनाया गया है या 'डेस्टिनेशन उपयोगकर्ता - सोर्स उपयोगकर्ता' जोड़े के लिए, मौजूदा एपीआई मॉनिटर को अपडेट किया गया है, तो आखिरी बार बनाया गया मॉनिटर इस जोड़े के लिए, पहले से मौजूद मॉनिटर की जगह ले लेगा. दरअसल, इस तरह से एपीआई मॉनिटर अपडेट किया जाता है. मॉनिटर अपडेट करने के बारे में ज़्यादा जानने के लिए, ईमेल मॉनिटर अपडेट करना देखें.
ईमेल मॉनिटर बनाना
ईमेल मॉनिटर बनाने के लिए, ईमेल मॉनिटर संसाधन की मदद से यह 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>
कामयाब होने पर, सर्वर नई मॉनिटर सेटिंग
दिखाते हुए entry
एलिमेंट के साथ 201 CREATED
स्टेटस कोड और AtomPub एंट्री दिखाता है:
<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
को अपडेट करके, ईमेल मॉनिटर बनाने के उदाहरण में बनाए गए मॉनिटर को अपडेट किया गया है. इस उदाहरण में इन पैरामीटर का इस्तेमाल किया गया है:
- नया
endDate
August 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>
कामयाब होने पर, सर्वर, अपडेट किए गए entry
एलिमेंट के साथ 201 CREATED
स्टेटस कोड और
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
स्टेटस कोड और entry
एलिमेंट के साथ AtomPub फ़ीड दिखाता है. यह दो मॉनिटर के लिए,
दो डेस्टिनेशन उपयोगकर्ताओं (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");