Memantau email

Untuk menyiapkan pemantauan email dengan Email Audit API, administrator menetapkan rentang tanggal bagi auditor untuk menerima salinan email yang dikirim pengguna tertentu dan menerima email sebagai lampiran. Jumlah maksimum pembuatan monitor dan permintaan penghapusan per hari adalah 1000 permintaan. Batas ini adalah per domain, dan mencakup semua permintaan yang dibuat oleh administrator pada siang hari.

Skenario email yang dipantau mencakup tiga jenis pengguna:

  • Administrator — Setiap administrator domain dapat membuat, mengambil, memperbarui, dan menghapus pemantau email menggunakan sumber daya pemantauan Email Audit API. Di beberapa selain itu, administrator dapat menggunakan API untuk mendownload kotak surat. Ini hanya dapat dilakukan di dalam domain di mana administrator kontrol terhadap latihan.

  • Pengguna sumber — Pengguna sumber adalah pengguna yang menerima atau mengirim pesan yang diaudit oleh pengguna tujuan pemantauan. Semua domain administrator atau pengguna akun dapat menjadi pengguna sumber. Pengguna sumber harus berada di domain yang sama dengan administrator dan pengguna tujuan.

  • Pengguna tujuan — Pengguna tujuan adalah auditor yang menerima pesan email yang telah diaudit.

    • Menerima salinan karbon tunanetra (Bcc) dari semua email masuk serta pesan email keluar, termasuk lampiran masuk dan keluar, pesan yang diteruskan, dan pesan email yang dikirim dari perangkat seluler.
    • Sebagai opsi, administrator domain dapat mengaktifkan audit tambahan untuk pengguna tujuan. Fitur opsional mencakup pengauditan draf email tersimpan, pengauditan chat Hangouts yang diarsipkan dengan pengguna lain yang dapat berada di dalam atau di luar domain.
    • Meskipun pengguna tujuan menerima salinan pesan di Bcc, pengaitan Bcc tidak terlihat di header pesan yang dapat diakses di akun pengguna sumber.
    • Setiap pesan email yang diaudit dikirim ke pengguna tujuan sebagai lampiran email. Dan administrator domain dapat mengkonfigurasi pesan menjadi pesan email lengkap atau hanya pesan {i>header<i}.
    • Pengguna tujuan ini harus memiliki akun email yang aktif di domain yang dipantau. Domain ini harus sama dengan yang dikaitkan dengan administrator dan pengguna sumber.
    • Pengguna tujuan dapat menjadi administrator atau pengguna dalam domain. Selain itu, pengguna tujuan ini dapat beralih peran untuk menjadi pengguna sumber diaudit oleh pengguna tujuan lain yang, pada gilirannya, menerima salinan semua pesan email yang diaudit dan dikirim ke pengguna tujuan pertama.
    • Administrator domain membuat satu pemantau email yang diaudit untuk satu email 'pengguna tujuan - pengguna sumber' berpasangan. Dengan kata lain, audit hubungan adalah satu pengguna tujuan ke satu pengguna sumber. Setiap audit dilakukan dengan menggunakan resource pemantau API. Menggunakan beberapa monitor API, pengguna tujuan dapat mengaudit banyak pengguna di domain. Selain itu, dengan menggunakan beberapa pemantauan API, banyak pengguna tujuan dapat mengaudit satu pengguna sumber.
    • Jika pemantau API tambahan dibuat atau pemantau API yang ada diperbarui untuk 'pengguna tujuan - pengguna sumber' pasangan, monitor yang yang terakhir dibuat menggantikan monitor yang sudah ada sebelumnya untuk pasangan ini. Pada dasarnya, ini adalah cara Anda memperbarui pemantauan API. Untuk informasi selengkapnya tentang memperbarui monitor, lihat Memperbarui pemantau email.

Buat pemantau email

Untuk membuat pemantau email, kirim permintaan POST berikut dengan email memantau resource:

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

Ganti kode berikut:

  • DOMAIN_NAME: nama domain Google Workspace—untuk misalnya, example.com.
  • SOURCE_USERNAME: nama pengguna yang Anda inginkan untuk dipantau.

Permintaan POST berisi header Content-type berikut:

Content-type: application/atom+xml

Untuk mengetahui daftar lengkap parameter yang dapat digunakan dalam permintaan pemantau email, lihat Materi: monitor.

Contoh untuk membuat monitor baru

Contoh ini menggunakan parameter berikut:

  • Pengguna yang akan diaudit adalah amal@example.com.
  • destUserName adalah izumi.
  • beginDate adalah June 15, 2022, 00:00 hours.
  • endDate adalah June 30, 2022, 23:20 hours.
  • incomingEmailMonitorLevel adalah FULL_MESSAGE.
  • outgoingEmailMonitorLevel adalah HEADER_ONLY.
  • draftMonitorLevel adalah FULL_MESSAGE.
  • chatMonitorLevel adalah 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>

Jika berhasil, server akan menampilkan kode status 201 CREATED dan entri AtomPub dengan elemen entry yang menunjukkan monitor baru pengaturan:

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

Memperbarui pemantau email

Saat memperbarui monitor dengan pengguna sumber dan pengguna tujuan yang sama, pengaturan properti monitor awal diganti dengan pengaturan baru.

Untuk memperbarui konfigurasi audit di pemantau email, kirim permintaan POST ke URI feed pemantauan dan sertakan header Authorization:

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

Ganti kode berikut:

  • DOMAIN_NAME: nama domain Google Workspace—untuk misalnya, example.com.
  • SOURCE_USERNAME: nama pengguna pemantau email yang ingin Anda perbarui.

Contoh cara memperbarui pemantau email

Contoh ini memperbarui monitor yang dibuat di contoh untuk membuat pemantau email dengan memperbarui properti wajib endDate dan properti opsional chatMonitorLevel. Contoh ini menggunakan parameter berikut:

  • endDate baru adalah August 30, 2022, 23:20 hours.
  • chatMonitorLevel sekarang menjadi HEADER_ONLY.
  • Pengguna yang akan diaudit tetap amal@example.com.
  • destUserName tetap izumi.

Properti monitor yang tidak diperbarui akan kembali ke nilai defaultnya. Sebagai Dalam contoh ini, incomingEmailMonitorLevel dan Properti outgoingEmailMonitorLevel dikembalikan ke FULL_MESSAGE, dan draftMonitorLevel dikembalikan ke NONE.

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>

Jika berhasil, server akan menampilkan kode status 201 CREATED dan entri AtomPub dengan elemen entry yang diperbarui. Properti yang tidak diperbarui dan ditampilkan dalam respons akan kembali ke nilai {i>default<i}. 

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

Mengambil semua pemantauan email pengguna sumber

Untuk mengambil semua monitor yang terkait dengan pengguna sumber, buat GET HTTP ke URI feed monitor, menggunakan format UTC untuk tanggal, dan menyertakan header Authorization:

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

Ganti kode berikut:

  • DOMAIN_NAME: nama domain Google Workspace—untuk misalnya, example.com.
  • SOURCE_USERNAME: nama pengguna pemantau email yang ingin Anda ambil.

Operasi ini tidak memiliki parameter dalam isi permintaan, sehingga isi XML kosong.

Contoh untuk mengambil semua pemantauan email

Contoh ini mengambil semua monitor yang dibuat untuk pengguna amal@example.com:

Protokol

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

Jika berhasil, server akan menampilkan kode status 201 CREATED dan sebuah feed AtomPub dengan elemen entry untuk dua monitor yang menunjukkan setelan untuk dua pengguna tujuan (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");

Menghapus pemantau email

Untuk menghapus pemantau email, buat permintaan DELETE HTTP ke feed pemantau hapus URI dan sertakan header Authorization:

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

Ganti kode berikut:

  • DOMAIN_NAME: nama domain Google Workspace—untuk misalnya, example.com.
  • SOURCE_USERNAME: nama pengguna pemantau email yang ingin Anda hapus.
  • DESTINATION_USERNAME: auditor yang menerima pesan email yang telah diaudit.

Contoh cara menghapus pemantau email

Contoh ini menghapus monitor yang dibuat untuk pengguna amal@example.com dengan destinationUserName sebagai izumi.

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