Bu sayfa, Cloud Translation API ile çevrilmiştir.

E-postaları izleme

E-posta Denetim API'sıyla e-posta izleme özelliğini ayarlamak için yönetici, denetçinin, belirli bir kullanıcı tarafından gönderilen iletilerin bir kopyasını alması e-postaları ek olarak aldı. Monitör oluşturma ve Günlük silme isteği sayısı 1.000 istektir. 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 bir e-posta senaryosunda üç tür kullanıcı bulunur:

Yönetici — Her alan yöneticisi oluşturabilir, alabilir, güncelleyebilir ve E-posta Denetimi API'sının izleme kaynağını kullanarak bir e-posta izleme işlemini silme. İçinde Ayrıca, bir yönetici posta kutusunu indirmek için API'yı kullanabilir. Bu işlemler, yalnızca yöneticinin bağlı olduğu alan adında gerçekleştirilebilir. ve kontrol gerektirir.
Kaynak kullanıcı - Kaynak kullanıcı, iletileri alan veya gönderen kullanıcıdır. izleme hedefi kullanıcısı tarafından denetlenen Herhangi bir alan yönetici 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ı, denetlenmiş e-posta iletileri olabilir.
- Tüm gelenlerin kör karbon kopyalarını (Bcc) alır gelen ve giden ekler dahil olmak üzere giden e-posta iletileri yönlendirilmiş iletiler ve mobil cihazlardan gönderilen e-posta iletileri gibi.
- Bir seçenek olarak, alan yöneticisi ek denetlemeyi etkinleştirebilir hedef kullanıcı için özellikler içerir. İsteğe bağlı özellikler arasında kayıtlı e-posta taslaklarının denetlenmesi, arşivlenmiş Hangouts sohbetlerinin denetlenmesi alan adının içinde veya dışında olabilecek diğer kullanıcılarla birlikte çalışır.
- Hedef kullanıcı iletinin Bcc kopyasını alsa bile, Bcc ilişkilendirmesi, erişilebilen ileti üstbilgilerinde görünmüyor kaynak kullanıcının hesabında yer alır.
- Denetlenen her e-posta iletisi hedef kullanıcıya e-posta eki olarak gönderebilirsiniz. Alan yöneticisi de bunları yapılandırabilir. Tam e-posta iletisi veya yalnızca ileti olacak şekilde başlıklar.
- Bu hedef kullanıcının izlenen bir alan adı olduğunu lütfen unutmayın. Bu, yönetici ve kaynak kullanıcı olabilir.
- Hedef kullanıcı, bir yönetici veya alan adındaki bir kullanıcı olabilir. Ayrıca bu hedef kullanıcı, rolünü değiştirerek kaynak kullanıcı bu kullanıcı, diğer bir hedef kullanıcı tarafından denetlenir. Bu kullanıcı İlk hedef kullanıcıya gönderilen, denetlenmiş tüm e-posta iletileri
- Alan yöneticisi, tek bir benzersiz adres için denetlenmiş e-posta izleme "hedef kullanıcı - kaynak kullanıcı" eşlemeye devam edin. Başka bir deyişle, bir hedef kullanıcı ile bir kaynak kullanıcı arasındaki ilişkidir. Her denetim API izleme kaynağı kullanılarak yapılır. Birden fazla API izleyicisi kullanarak alandaki birçok kullanıcıyı denetleyebilir. Ve birden çok API izleyicisi varsa birçok hedef kullanıcı bir kaynak kullanıcıyı denetleyebilir.
- Ek bir API izleyicisi oluşturulursa veya mevcut bir API izleyicisi "hedef kullanıcı - kaynak kullanıcı" olarak güncellendi cihazın hangi cihazda çalıştırılacağını olarak ayarlanmış cihaz, bu çift için önceden mevcut olan tüm monitörlerin yerini alır. Temel olarak bir API izleyicisini bu şekilde güncellersiniz. Okuyucu Gelirleri Yöneticisi'ni öğrenmek için bkz. E-posta izleme işlemini güncelleme.

E-posta izleme işlemi oluşturma

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

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ı - için örnek.com.
SOURCE_USERNAME: istediğiniz kullanıcı adı takip etmek anlamına gelir.

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.

Yeni monitör oluşturma örneği

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

Başarılı olursa sunucu bir 201 CREATED durum kodu döndürür ve yeni monitörü gösteren entry öğesine sahip bir AtomPub girişi Ayarlar:

<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 işlemini güncelleme

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

E-posta izlemede denetim yapılandırmasını güncellemek için, şu adrese bir POST isteği gönderin: izleme feed'inin URI'sını ekleyin ve Authorization başlığını dahil edin:

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ı - için örnek.com.
SOURCE_USERNAME: e-posta izleme aracının kullanıcı adı tıklayın.

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

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

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

Güncellenmemiş monitör özellikleri, varsayılan değerlerine döner. Örneğin, Bu örnekte incomingEmailMonitorLevel ve outgoingEmailMonitorLevel mülkleri FULL_MESSAGE değerine geri döner ve draftMonitorLevel, NONE değerine geri döner.

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>

Başarılı olursa sunucu bir 201 CREATED durum kodu döndürür ve güncellenen entry öğeleri içeren bir AtomPub girişi. Tesisler gösterilmeyenler ve yanıtta gösterilenler varsayılan değerlerine geri döndürülür.

<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 izleyicilerini al

Kaynak kullanıcıyla ilişkili tüm monitörleri almak için HTTP GET yapın. isteği izleme feed URI'sine göndermek için, tarih için UTC biçimini kullanır ve Authorization başlığı:

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ı - için örnek.com.
SOURCE_USERNAME: e-posta izleme aracının kullanıcı adı seçin.

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

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

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

Protokol

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

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

<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 izleyiciyi silmek için izleme feed'inin DELETE URI'yı silin ve Authorization üstbilgisini 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ı - için örnek.com.
SOURCE_USERNAME: e-posta izleme aracının kullanıcı adı tıklayın.
DESTINATION_USERNAME: Belgeyi alan denetçi denetlenmiş e-posta iletileri olabilir.

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

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

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