مراقبة الرسائل الإلكترونية

لإعداد مراقبة البريد الإلكتروني باستخدام واجهة برمجة تطبيقات تدقيق البريد الإلكتروني، يحدد المشرف نطاقًا زمنيًا للمدقق لاستلام نسخة من رسائل البريد الإلكتروني المرسلة والمستلمة من مستخدم معين كمرفق. يبلغ الحد الأقصى لعدد طلبات إنشاء أداة الرصد وحذفها يوميًا 1000 طلب. يُطبَّق هذا الحدّ الأقصى على كلّ نطاق، وسيتضمّن جميع الطلبات التي أجراها أيّ مشرف خلال اليوم.

يتضمن سيناريو البريد الإلكتروني الذي يتم تتبّعه ثلاثة أنواع من المستخدمين:

  • المشرف — يمكن لأي مشرف نطاق إنشاء أداة مراقبة للبريد الإلكتروني واستردادها وتحديثها وحذفها باستخدام مورد المراقبة لواجهة برمجة التطبيقات Email Audit API. بالإضافة إلى ذلك، يمكن للمشرف استخدام واجهة برمجة التطبيقات لتنزيل صندوق البريد. ولا يمكن تنفيذ هذه العمليات إلا داخل النطاق الذي يمارس المشرف التحكم فيه.

  • المستخدم المصدر: المستخدم المصدر هو المستخدم الذي يتلقى أو يرسل الرسائل التي يتم تدقيقها بواسطة مستخدم وجهة المراقبة. ويمكن لأي مشرف نطاق أو مستخدم حساب أن يكون مستخدمًا مصدرًا. يجب أن يكون المستخدم المصدر في نفس النطاق مثل المشرف والمستخدم الوجهة.

  • المستخدم الوجهة — يكون المستخدم الوجهة هو المدقق الذي يتلقى الرسائل الإلكترونية للتدقيق.

    • يتلقى نُسخًا كربونية مشفَّرة (نسخة مخفية الوجهة) لجميع رسائل البريد الإلكتروني الواردة والصادرة، بما في ذلك المرفقات الواردة والصادرة والرسائل المُعاد توجيهها والرسائل الإلكترونية المُرسَلة من أجهزة جوّالة.
    • كخيار، يمكن لمشرف النطاق تفعيل ميزات تدقيق إضافية للمستخدم الوجهة. تتضمن الميزات الاختيارية مراجعة مسودات البريد الإلكتروني المحفوظة وتدقيق محادثات 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>

في حال نجاح هذا الإجراء، يعرض الخادم رمز حالة 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 إلى معرّف الموارد المنتظم (URI) لخلاصة المراقبة مع تضمين رأس 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 وإدخال AtomPub مع عناصر entry المعدّلة. تعود السمات التي لم يتم تعديلها وعرضها في الرد إلى القيم التلقائية. 

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

استرداد جميع أدوات مراقبة البريد الإلكتروني لمستخدم المصدر

لاسترداد جميع الشاشات المرتبطة بمستخدم مصدر، يمكنك تقديم طلب HTTP GET إلى معرّف الموارد المنتظم (URI) لخلاصة المراقبة، باستخدام تنسيق UTC (التوقيت العالمي المنسق) للتاريخ، مع تضمين رأس 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: اسم المستخدم لمراقبة البريد الإلكتروني التي تريد استردادها.

لا تشتمل هذه العملية على أي معلمات في نص الطلب، وبالتالي فإن نص XML فارغ.

مثال لاسترداد كل أدوات مراقبة البريد الإلكتروني

يسترد هذا المثال جميع أجهزة العرض التي تم إنشاؤها للمستخدم 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");

حذف أداة مراقبة البريد الإلكتروني

لحذف أداة مراقبة البريد الإلكتروني، يمكنك تقديم طلب HTTP DELETE إلى معرف الموارد المنتظم (URI) لحذف خلاصة المراقبة وتضمين رأس 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");