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

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

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

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

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

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

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