ईमेल की निगरानी करना

Email Audit API की मदद से ईमेल मॉनिटरिंग सेट अप करने के लिए, एडमिन एक तारीख की सीमा सेट करता है. इससे ऑडिटर को किसी उपयोगकर्ता के भेजे और पाए गए ईमेल की कॉपी, अटैचमेंट के तौर पर मिलती है. हर दिन, मॉनिटर बनाने और मिटाने के लिए ज़्यादा से ज़्यादा 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 है.
प्रोटोकॉलJava.NET
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 स्टेटस कोड और entry एलिमेंट के साथ एक 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>
 
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);
 
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 पर वापस आ जाती है.

प्रोटोकॉलJava.NET
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>
 
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);
 
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 के लिए बनाए गए सभी मॉनिटर दिखाए गए हैं:

प्रोटोकॉलJava.NET
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>
 
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");
 
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 के तौर पर सेट किया गया है.

प्रोटोकॉलJava.NET
DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal/izumi
 
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");
 
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");