E-postaları izleme

Yönetici, Email Audit API ile e-posta izlemeyi ayarlamak için denetleyicinin belirli bir kullanıcının gönderdiği ve aldığı e-postaların kopyasını ek olarak alabilmesi için bir tarih aralığı belirler. Günlük maksimum izleme oluşturma ve silme isteği sayısı 1.000'dir. Bu sınır alan başınadır ve gün içinde herhangi bir yönetici tarafından yapılan tüm istekleri içerir.

İzlenen e-posta senaryosu üç tür kullanıcı içerir:

  • Yönetici: Tüm alan yöneticileri, E-posta Denetleme API'sinin izleyici kaynağını kullanarak e-posta izleyici oluşturabilir, alabilir, güncelleyebilir ve silebilir. Ayrıca, yöneticiler API'yi kullanarak posta kutusunu indirebilir. Bu işlemler yalnızca yöneticinin kontrol sahibi olduğu alan içinde yapılabilir.

  • Kaynak kullanıcı: Kaynak kullanıcı, izleme hedef kullanıcısı tarafından denetlenen iletileri alan veya gönderen kullanıcıdır. Herhangi bir alan yöneticisi veya hesap kullanıcısı kaynak kullanıcı olabilir. Kaynak kullanıcı, yönetici ve hedef kullanıcıyla aynı alanda olmalıdır.

  • Hedef kullanıcı: Hedef kullanıcı, denetlenen e-posta iletilerini alan denetleyicidir.

    • Gelen ve giden ekler, yönlendirilen iletiler ve mobil cihazlardan gönderilen e-posta iletileri dahil olmak üzere tüm gelen ve giden e-posta iletilerinin gizli kopyalarını (Bcc) alır.
    • Alan yöneticileri, hedef kullanıcı için ek denetim özelliklerini etkinleştirebilir. İsteğe bağlı özellikler arasında, kaydedilen e-posta taslaklarının denetlenmesi ve alan içinde veya dışındaki diğer kullanıcılarla yapılan arşivlenmiş Hangouts sohbetlerinin denetlenmesi yer alır.
    • Hedef kullanıcı, iletinin Bcc kopyasını alsa bile Bcc ilişkilendirmesi, kaynak kullanıcının hesabından erişilebilen ileti üstbilgilerinde görünmez.
    • Denetlenen her e-posta mesajı, hedef kullanıcıya e-posta eki olarak gönderilir. Alan yöneticisi, bu iletileri tam e-posta iletisi veya yalnızca ileti üstbilgileri olacak şekilde yapılandırabilir.
    • Bu hedef kullanıcının, izlenen alanda etkin bir e-posta hesabı olmalıdır. Bu, yönetici ve kaynak kullanıcıyla ilişkilendirilmiş alanla aynı olmalıdır.
    • Hedef kullanıcı, alan yöneticisi veya alan içindeki bir kullanıcı olabilir. Bu hedef kullanıcı, rol değiştirerek başka bir hedef kullanıcı tarafından denetlenen bir kaynak kullanıcı haline gelebilir. Bu hedef kullanıcı da ilk hedef kullanıcıya gönderilen tüm denetlenen e-posta iletilerinin kopyalarını alır.
    • Alan yöneticileri, benzersiz bir "hedef kullanıcı - kaynak kullanıcı" çifti için bir denetlenen e-posta izleyici oluşturur. Diğer bir deyişle, denetim ilişkisi bir hedef kullanıcı ile bir kaynak kullanıcı arasındadır. Her denetim, bir API izleyici kaynağı kullanılarak yapılır. Hedef kullanıcı, birden fazla API izleyici kullanarak alandaki birçok kullanıcıyı denetleyebilir. Ayrıca, birden fazla API izleyici kullanarak birçok hedef kullanıcı tek bir kaynak kullanıcıyı denetleyebilir.
    • Bir "hedef kullanıcı - kaynak kullanıcı" çifti için ek bir API izleyici oluşturulursa veya mevcut bir API izleyici güncellenirse en son oluşturulan izleyici, bu çift için önceden var olan tüm izleyicilerin yerini alır. API izleyiciyi temel olarak bu şekilde güncelleyebilirsiniz. İzleyiciyi güncelleme hakkında daha fazla bilgi için E-posta izleyiciyi güncelleme başlıklı makaleyi inceleyin.

E-posta izleme işlemi oluşturma

E-posta izleme işlemi oluşturmak için e-posta izleme kaynağıyla birlikte aşağıdaki POST isteğini gönderin:

POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME

Aşağıdakini değiştirin:

  • DOMAIN_NAME: Google Workspace alan adı (ör. example.com).
  • SOURCE_USERNAME: İzlemek istediğiniz kullanıcı adı.

POST isteği aşağıdaki Content-type başlığını içeriyor:

Content-type: application/atom+xml

E-posta izleyici isteğinde kullanılacak parametrelerin tam listesi için Kaynaklar: monitor bölümüne bakın.

Yeni bir izleyici oluşturma örneği

Örnekte aşağıdaki parametreler kullanılmıştır:

  • Denetlenecek kullanıcı amal@example.com.
  • destUserName artık izumi.
  • beginDate artık June 15, 2022, 00:00 hours.
  • endDate artık June 30, 2022, 23:20 hours.
  • incomingEmailMonitorLevel artık FULL_MESSAGE.
  • outgoingEmailMonitorLevel artık HEADER_ONLY.
  • draftMonitorLevel artık FULL_MESSAGE.
  • chatMonitorLevel artık FULL_MESSAGE.
ProtokolJava.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>

İşlem başarılı olursa sunucu bir 201 CREATED durum kodu ve yeni monitör ayarlarını gösteren entry öğesini içeren bir AtomPub girişi döndürür:

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

E-posta izleme işlemini güncelleme

Bir monitörü aynı kaynak kullanıcı ve hedef kullanıcıyla güncellerken ilk monitörün özellik ayarları yeni ayarlarla değiştirilir.

Bir e-posta izleyicisindeki denetim yapılandırmasını güncellemek için izleyici feed'inin URI'sine bir POST isteği gönderin ve Authorization üstbilgisini ekleyin:

POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME

Aşağıdakini değiştirin:

  • DOMAIN_NAME: Google Workspace alan adı (ör. example.com).
  • SOURCE_USERNAME: Güncellemek istediğiniz e-posta izleyicinin kullanıcı adı.

E-posta izleyiciyi güncelleme örneği

Bu örnekte, gerekli endDate özelliğini ve isteğe bağlı chatMonitorLevel özelliğini güncelleyerek e-posta izleyici oluşturma örneğinde oluşturulan izleyici güncellenmektedir. Bu örnekte aşağıdaki parametreler kullanılmaktadır:

  • Yeni endDate August 30, 2022, 23:20 hours oldu.
  • chatMonitorLevel artık HEADER_ONLY.
  • Denetlenecek kullanıcı amal@example.com olarak kalır.
  • destUserName, izumi olarak kalır.

Güncellenmeyen monitör özellikleri varsayılan değerlerine döner. Örneğin, bu örnekte incomingEmailMonitorLevel ve outgoingEmailMonitorLevel özellikleri FULL_MESSAGE, draftMonitorLevel ise NONE olarak geri döner.

ProtokolJava.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>

İşlem başarılı olursa sunucu bir 201 CREATED durum kodu ve güncellenmiş entry öğelerini içeren bir AtomPub girişi döndürür. Güncellenmeyen ve yanıtta gösterilmeyen özellikler varsayılan değerlerine döner. 

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

Bir kaynak kullanıcının tüm e-posta izleyicilerini alma

Bir kaynak kullanıcıyla ilişkili tüm monitörleri almak için tarih için UTC biçimini kullanarak monitör feed'i URI'sine bir HTTP GETisteğinde bulunun ve Authorization başlığını ekleyin:

GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME

Aşağıdakini değiştirin:

  • DOMAIN_NAME: Google Workspace alan adı (ör. example.com).
  • SOURCE_USERNAME: Alınmasını istediğiniz e-posta izleyicinin kullanıcı adı.

Bu işlemde istek metninde parametre olmadığından XML metni boştur.

Tüm e-posta izleyicileri alma örneği

Bu örnekte, amal@example.com kullanıcısı için oluşturulan tüm monitörler alınır:

ProtokolJava.NET
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/example.com/amal

İşlem başarılı olursa sunucu bir 201 CREATED durum kodu ve iki hedef kullanıcının (izumi@example.com, taylor@example.com) ayarlarını gösteren iki monitör için entry öğelerini içeren bir AtomPub feed'i döndürür.

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

E-posta izleme işlemini silme

Bir e-posta izleme işlemini silmek için izleme feed'inin silme URI'sine bir HTTP DELETE isteği gönderin ve Authorization üst bilgisini ekleyin:

DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/monitor/DOMAIN_NAME/SOURCE_USERNAME/DESTINATION_USERNAME

Aşağıdakini değiştirin:

  • DOMAIN_NAME: Google Workspace alan adı (ör. example.com).
  • SOURCE_USERNAME: Silmek istediğiniz e-posta izleyicinin kullanıcı adı.
  • DESTINATION_USERNAME: Denetlenen e-posta iletilerini alan denetleyici.

E-posta izleme işlemini silme örneği

Bu örnekte, destinationUserName değeri izumi olan amal@example.com kullanıcısı için oluşturulan monitörler silinmektedir.

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