E-postaları izleme

Bir yönetici, E-posta Denetimi API'sıyla e-posta izlemeyi ayarlamak için denetçinin belirli bir kullanıcının gönderdiği ve aldığı e-postaların kopyasını ek olarak alacağı 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 adı başınadır ve gün içinde herhangi bir yönetici tarafından gönderilen tüm istekleri içerir.

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

  • Yönetici: Herhangi bir alan yöneticisi, Email Audit API'nin izleme kaynağını kullanarak bir e-posta izleme özelliğini oluşturabilir, alabilir, güncelleyebilir ve silebilir. Ayrıca, bir yönetici posta kutusunu indirmek için API'yi kullanabilir. Bu işlemler yalnızca yöneticinin kontrol sahibi olduğu alan adında gerçekleştirilebilir.

  • Kaynak kullanıcı — Kaynak kullanıcı, izleme hedef kullanıcısı tarafından denetlenen mesajları 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 mesajlarını alan denetçidir.

    • Gelen ve giden ekler, yönlendirilen iletiler ve mobil cihazlardan gönderilen e-posta iletileri de dahil olmak üzere tüm gelen ve giden e-posta iletilerinin gizli karbon kopyalarını (Bcc) alır.
    • Alternatif olarak, alan yöneticisi hedef kullanıcı için ek denetim özelliklerini etkinleştirebilir. İsteğe bağlı özellikler arasında kayıtlı e-posta taslaklarının ve alan adının içinde veya dışında olabilecek diğer kullanıcılarla 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 e-posta iletilerinin her biri hedef kullanıcıya e-posta eki olarak gönderilir. Ayrıca, 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 alan, yönetici ve kaynak kullanıcıyla ilişkilendirilmiş alan adı olmalıdır.
    • Hedef kullanıcı, bir yönetici veya alan adındaki bir kullanıcı olabilir. Ayrıca bu hedef kullanıcı, başka bir hedef kullanıcı tarafından denetlenen bir kaynak kullanıcı olmak için rolünü değiştirebilir. Bu kullanıcı da ilk hedef kullanıcıya gönderilen, denetlenmiş tüm e-posta mesajlarının kopyalarını alır.
    • Alan yöneticisi, benzersiz bir "hedef kullanıcı - kaynak kullanıcı" çifti için denetlenen bir e-posta izleme aracı oluşturur. Başka bir deyişle denetim ilişkisi, bir hedef kullanıcı ile kaynak kullanıcı arasında bir ilişkiyi oluşturur. Her denetim, bir API izleyici kaynağı kullanılarak yapılır. Hedef kullanıcı, birden fazla API izleyicisi kullanarak alandaki birçok kullanıcıyı denetleyebilir. Ayrıca birden fazla API izleyicisi kullanan birçok hedef kullanıcı, tek bir kaynak kullanıcıyı denetleyebilir.
    • "Hedef kullanıcı - kaynak kullanıcı" çifti için ek bir API izleyicisi oluşturulursa veya mevcut bir API izleyicisi güncellenirse son oluşturulan monitör, bu çifte yönelik önceden mevcut olan tüm monitörlerin yerini alır. Temel olarak API monitörünü bu şekilde güncellersiniz. Monitör güncelleme hakkında daha fazla bilgi için E-posta izleyiciyi güncelleme bölümüne göz atın.

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ı; örneğin, example.com.
  • SOURCE_USERNAME: İzlemek istediğiniz kullanıcı adıdır.

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

Content-type: application/atom+xml

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

Yeni monitör oluşturma örneği

Örnekte aşağıdaki parametreler kullanılı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.

Protokol

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 öğesinin yer aldığı 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>

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

E-posta izleme ayarlarını güncelleme

Bir monitör aynı kaynak ve hedef kullanıcı ile güncellenirken, ilk izleyicinin mülk ayarları yeni ayarlarla değiştirilir.

Bir e-posta izlemesinde denetim yapılandırmasını güncellemek için izleme feed'inin URI'sine bir POST isteği gönderin ve Authorization üst bilgisini 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ı; örneğin, example.com.
  • SOURCE_USERNAME: Güncellemek istediğiniz e-posta izleyicinin kullanıcı adı.

E-posta izleme işlemini güncelleme örneği

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

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

Güncellenmemiş izleme özellikleri, varsayılan değerlerine geri döner. Örneğin bu örnekte incomingEmailMonitorLevel ve outgoingEmailMonitorLevel özellikleri FULL_MESSAGE değerine, draftMonitorLevel özellikleri de NONE değerine geri döndürülür.

Protokol

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, 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österilen özellikler varsayılan değerlerine geri 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>

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

Bir kaynak kullanıcının tüm e-posta izlemelerini al

Bir kaynak kullanıcıyla ilişkili tüm monitörleri almak için tarih için UTC biçimini kullanarak izleme feed URI'sine HTTP GET isteği yapın ve Authorization üst bilgisini 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ı; örneğin, example.com.
  • SOURCE_USERNAME: Geri almak istediğiniz e-posta izleyicinin kullanıcı adı.

Bu işlemin istek gövdesinde parametre olmadığından XML gövdesi boş.

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

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

Protokol

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

İşlem başarılı olursa sunucu, iki hedef kullanıcının (izumi@example.com, taylor@example.com) ayarlarını gösteren bir 201 CREATED durum kodu ve 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>

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

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ı; örneğin, example.com.
  • SOURCE_USERNAME: Silmek istediğiniz e-posta izleyicinin kullanıcı adı.
  • DESTINATION_USERNAME: denetlenen e-posta mesajlarını alan denetçi.

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

Bu örnek, izumi olarak destinationUserName ile amal@example.com kullanıcısı için oluşturulan monitörleri siler.

Protokol

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