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

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

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

المشرف: يمكن لأي مشرف نطاق إنشاء أداة مراقبة البريد الإلكتروني واستردادها وتعديلها وحذفها باستخدام مورد المراقبة في Email Audit API. بالإضافة إلى ذلك، يمكن للمشرف استخدام واجهة برمجة التطبيقات لتنزيل صندوق البريد. لا يمكن إجراء هذه العمليات إلا ضمن النطاق الذي يمارس المشرف سيطرته عليه.
المستخدم المصدر: هو المستخدم الذي يتلقّى الرسائل أو يرسلها، ويتم تدقيقها من قِبل حساب المستخدِم المقصود الذي يراقب الرسائل. يمكن أن يكون أي مشرف نطاق أو مستخدم حساب مستخدمًا مصدرًا. يجب أن يكون المستخدم المصدر في النطاق نفسه الذي ينتمي إليه المشرف وحساب المستخدِم المقصود.
حساب المستخدِم المقصود: هو المدقّق الذي يتلقّى رسائل البريد الإلكتروني التي تم تدقيقها.
- يتلقّى نسخًا مخفية الوجهة (Bcc) من جميع رسائل البريد الإلكتروني الواردة والصادرة، بما في ذلك المرفقات الواردة والصادرة والرسائل المعاد توجيهها ورسائل البريد الإلكتروني المرسَلة من الأجهزة الجوّالة.
- كخيار، يمكن لمشرف النطاق تفعيل ميزات تدقيق إضافية لحساب المستخدِم المقصود. تشمل الميزات الاختيارية تدقيق مسودات الرسائل الإلكترونية المحفوظة، وتدقيق محادثات Google Chat المؤرشفة مع مستخدمين آخرين يمكن أن يكونوا داخل النطاق أو خارجه.
- على الرغم من أنّ المستخدم الوجهة يتلقّى نسخة مخفيّة الوجهة من الرسالة، لا يظهر الربط بين النسخة المخفيّة الوجهة والمستخدم في عناوين الرسائل التي يمكن الوصول إليها في حساب المستخدم المصدر.
- يتم إرسال كل رسالة إلكترونية خاضعة للتدقيق إلى حساب المستخدِم المقصود كمرفق في رسالة إلكترونية. ويمكن لمشرف النطاق ضبط هذه الرسائل لتكون إما رسالة البريد الإلكتروني الكاملة أو عناوين الرسائل فقط.
- يجب أن يكون لدى حساب المستخدِم المقصود حساب بريد إلكتروني نشط في النطاق الذي تتم مراقبته. يجب أن يكون هذا هو النطاق نفسه المرتبط بالمشرف والمستخدم المصدر.
- يمكن أن يكون حساب المستخدِم المقصود مشرفًا أو مستخدمًا ضمن النطاق. ويمكن لحساب المستخدِم المقصود هذا تبديل الأدوار ليصبح مستخدمًا مصدرًا يخضع للتدقيق من قِبل حساب مستخدِم مقصود آخر يتلقّى بدوره نُسخًا من جميع الرسائل الإلكترونية التي تم تدقيقها والمُرسَلة إلى حساب المستخدِم المقصود الأول.
- ينشئ مشرف النطاق عملية مراقبة واحدة لرسائل البريد الإلكتروني التي تم تدقيقها لكل زوج فريد من "المستخدم الوجهة - المستخدم المصدر". بعبارة أخرى، تكون علاقة التدقيق بين حساب المستخدِم المقصود واحد ومستخدم مصدر واحد. يتم إجراء كل عملية تدقيق باستخدام مورد مراقبة واجهة برمجة التطبيقات. باستخدام أدوات مراقبة متعددة لواجهات برمجة التطبيقات، يمكن لحساب المستخدِم المقصود تدقيق العديد من المستخدمين في النطاق. باستخدام أدوات مراقبة متعددة لواجهة برمجة التطبيقات، يمكن للعديد من المستخدمين المستهدَفين تدقيق مستخدم مصدر واحد.
- في حال إنشاء أداة مراقبة إضافية لواجهة برمجة التطبيقات أو تعديل أداة مراقبة حالية لواجهة برمجة التطبيقات لزوج "حساب المستخدِم المقصود - المستخدم المصدر"، تحلّ أداة المراقبة التي تم إنشاؤها آخر مرة محل أي أدوات مراقبة سابقة لهذا الزوج. في ما يلي كيفية تعديل عملية مراقبة واجهة برمجة التطبيقات. لمزيد من المعلومات حول تعديل أداة مراقبة، يُرجى الاطّلاع على مقالة تعديل أداة مراقبة البريد الإلكتروني.

إنشاء حدث مراقبة للبريد الإلكتروني

لإنشاء حدث مراقبة للبريد الإلكتروني، أرسِل طلب 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>

جافا

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>

جافا

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>

جافا

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

جافا

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

مراقبة الرسائل الإلكترونية تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إنشاء حدث مراقبة للبريد الإلكتروني

مثال على إنشاء شاشة مراقبة جديدة

البروتوكول

جافا

NET.

تعديل حدث مراقبة للبريد الإلكتروني

مثال على تعديل حدث مراقبة للبريد الإلكتروني

البروتوكول

جافا

NET.

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

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

البروتوكول

جافا

NET.

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

مثال على حذف مراقب البريد الإلكتروني

البروتوكول

جافا

NET.

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