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

ईमेल ऑडिट एपीआई की मदद से ईमेल को मॉनिटर करने की सुविधा सेट अप करने के लिए, एडमिन ऑडिटर को किसी उपयोगकर्ता के भेजे गए दस्तावेज़ की कॉपी पाने की तारीख की सीमा और अटैचमेंट के रूप में ईमेल मिले. इससे ज़्यादा मॉनिटर नहीं बनाए जा सकते और डेटा मिटाने के हर दिन मिलने वाले अनुरोधों की संख्या 1,000 है. यह सीमा प्रति डोमेन है, और इसमें दिन के दौरान किसी एडमिन की ओर से किए गए सभी अनुरोध शामिल होते हैं.

मॉनिटर किए गए ईमेल से जुड़े मामलों में, तीन तरह के उपयोगकर्ता शामिल होते हैं:

  • व्यवस्थापक — कोई भी डोमेन व्यवस्थापक बना सकता है, पुनर्प्राप्त कर सकता है, अपडेट कर सकता है, और ईमेल ऑडिट एपीआई के मॉनिटर संसाधन का इस्तेमाल करके, ईमेल मॉनिटर को मिटाएं. तय सीमा में इसके अलावा, एडमिन मेलबॉक्स को डाउनलोड करने के लिए एपीआई का इस्तेमाल कर सकता है. ये कार्रवाइयां केवल उस डोमेन में की जा सकती हैं जिस पर व्यवस्थापक व्यायाम नियंत्रण.

  • सोर्स उपयोगकर्ता — सोर्स उपयोगकर्ता वह उपयोगकर्ता होता है जो मैसेज पाता है या भेजता है जिनका ऑडिट निगरानी करने वाले डेस्टिनेशन के उपयोगकर्ता से किया जा रहा हो. कोई भी डोमेन एडमिन या खाते का उपयोगकर्ता, सोर्स उपयोगकर्ता हो सकता है. स्रोत उपयोगकर्ता को यह ज़रूरी है उसी डोमेन में हो जिसमें एडमिन और डेस्टिनेशन उपयोगकर्ता हों.

  • गंतव्य उपयोगकर्ता — गंतव्य उपयोगकर्ता वह ऑडिटर होता है जिसे ऑडिट किए गए ईमेल मैसेज.

    • आने वाले सभी कॉल की ब्लाइंड कार्बन कॉपी (गुप्त कॉपी) पाएं और आउटगोइंग ईमेल मैसेज, जिनमें इनबाउंड और आउटबाउंड अटैचमेंट शामिल हैं, फ़ॉरवर्ड किए गए मैसेज और मोबाइल डिवाइस से भेजे गए ईमेल मैसेज.
    • विकल्प के तौर पर, डोमेन एडमिन अतिरिक्त ऑडिटिंग चालू कर सकता है डेस्टिनेशन उपयोगकर्ता के लिए सुविधाएं. वैकल्पिक सुविधाओं में ये शामिल हैं: सेव किए गए ईमेल ड्राफ़्ट की ऑडिटिंग, संग्रहित Hangouts चैट की ऑडिटिंग डोमेन में या उसके बाहर मौजूद अन्य उपयोगकर्ताओं के साथ किया जा सकता है.
    • भले ही, डेस्टिनेशन उपयोगकर्ता को मैसेज की गुप्त कॉपी मिलती हो, गुप्त कॉपी फ़ील्ड से जुड़ी जानकारी, मैसेज के ऐक्सेस किए जा सकने वाले हेडर में नहीं दिखती उपयोगकर्ता के खाते में.
    • ऑडिट किए गए हर ईमेल को डेस्टिनेशन उपयोगकर्ता को, इस ईमेल पते के तौर पर भेजा जाता है: ईमेल अटैचमेंट मौजूद है. और डोमेन व्यवस्थापक इन्हें कॉन्फ़िगर कर सकता है संदेश या तो पूर्ण ईमेल संदेश हों या केवल संदेश हों हेडर.
    • इस गंतव्य उपयोगकर्ता का एक सक्रिय ईमेल खाता मॉनिटर किया गया डोमेन. यह वही डोमेन होना चाहिए जो एडमिन और सोर्स उपयोगकर्ता की पहचान करता है.
    • गंतव्य उपयोगकर्ता एक व्यवस्थापक या डोमेन का उपयोगकर्ता हो सकता है. साथ ही, यह डेस्टिनेशन उपयोगकर्ता, सोर्स उपयोगकर्ता बनने के लिए भूमिकाएं बदल सकता है किसी अन्य गंतव्य उपयोगकर्ता द्वारा ऑडिट किया गया हो, जो बदले में, ऑडिट किए गए सभी ईमेल मैसेज, जिन्हें पहले डेस्टिनेशन उपयोगकर्ता को भेजा गया था.
    • डोमेन एडमिन किसी यूनीक ईमेल पते के लिए, ऑडिट किया गया एक ईमेल मॉनिटर बनाता है 'डेस्टिनेशन उपयोगकर्ता - सोर्स उपयोगकर्ता' जोड़ी. दूसरे शब्दों में, ऑडिट संबंध एक गंतव्य उपयोगकर्ता से एक स्रोत उपयोगकर्ता है. हर ऑडिट एपीआई मॉनिटर संसाधन का इस्तेमाल करके किया जाता है. एक से ज़्यादा एपीआई मॉनिटर का इस्तेमाल करके, गंतव्य उपयोगकर्ता डोमेन के कई उपयोगकर्ताओं का ऑडिट कर सकता है. और इसका इस्तेमाल करके का उपयोग करते हैं, तो कई गंतव्य उपयोगकर्ता एक स्रोत उपयोगकर्ता का ऑडिट कर सकते हैं.
    • अगर कोई अतिरिक्त एपीआई मॉनिटर बनाया जाता है या मौजूदा एपीआई मॉनिटर 'डेस्टिनेशन उपयोगकर्ता - सोर्स उपयोगकर्ता' के लिए अपडेट किया गया इसलिए, वह मॉनिटर आखिरी बार बनाया गया था. यह इस जोड़े के लिए पहले से मौजूद किसी भी मॉनिटर की जगह लेता है. बुनियादी तौर पर, एपीआई मॉनिटर को इस तरह अपडेट किया जाता है. Reader Revenue Manager को सेट अप करने के बारे में अपडेट करने के बारे में जानने के लिए, देखें ईमेल मॉनिटर को अपडेट करना.

ईमेल मॉनिटर बनाना

ईमेल मॉनिटर बनाने के लिए, ईमेल के साथ यह 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. इस उदाहरण में, इन पैरामीटर का इस्तेमाल किया गया है:

  • नया 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>

सही होने पर, सर्वर एक 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 स्टेटस कोड दिखाता है और दो मॉनिटर के लिए, 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 के लिए बनाए गए मॉनिटर मिटा देता है izumi के तौर पर destinationUserName की सदस्यता लें.

प्रोटोकॉल

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");