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ıkizumi
.beginDate
artıkJune 15, 2022, 00:00 hours
.endDate
artıkJune 30, 2022, 23:20 hours
.incomingEmailMonitorLevel
artıkFULL_MESSAGE
.outgoingEmailMonitorLevel
artıkHEADER_ONLY
.draftMonitorLevel
artıkFULL_MESSAGE
.chatMonitorLevel
artıkFULL_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ıkHEADER_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");