Halaman ini diterjemahkan oleh Cloud Translation API.

Mendownload kotak surat

Sebagai administrator, Anda dapat mendownload akun kotak surat dalam domain untuk tujuan audit. Untuk menyiapkan kotak surat untuk diekspor, Email Audit API membuat salinan terenkripsi kotak surat pengguna. Sistem menampilkan URL untuk file kotak surat terenkripsi yang, saat didownload dan didekripsi, tersedia dalam format mbox.

Permintaan pembuatan ekspor kotak surat maksimum per hari adalah total 100 permintaan dari semua administrator domain. Proses pembuatan kotak surat dapat memakan waktu yang lama dan mungkin memerlukan waktu beberapa hari, bergantung pada ukuran kotak surat.

Google menyimpan file kotak surat terenkripsi selama 3 minggu, jadi pastikan Anda mendownload file kotak surat ini dalam jangka waktu ini. Setelah waktu tersebut, data tersebut akan dihapus. Untuk menghapus file kotak surat ini sebelum jangka waktu berakhir, lihat Menghapus kotak surat terenkripsi.

Untuk mendownload kotak surat, lakukan tindakan berikut:

Buat dan upload kunci publik — Buat kunci enkripsi publik untuk mendownload kotak surat. Langkah ini hanya perlu dilakukan sekali. Jika sudah membuat kunci publik, Anda tidak perlu menyelesaikan langkah ini untuk setiap ekspor kotak surat.
Membuat versi ekspor kotak surat pengguna — Proses ekspor kotak surat dimulai saat Anda meminta pembuatan salinan kotak surat pengguna. Email Audit API mengautentikasi dan memberikan otorisasi pada kredensial Anda dan menampilkan ID permintaan unik. Proses pembuatan kotak surat dapat memakan waktu dan mungkin memerlukan waktu beberapa hari, bergantung pada ukuran kotak surat.
Mengambil status download kotak surat — Gunakan ID permintaan ekspor kotak surat untuk mendapatkan status permintaan yang tertunda. Setelah kotak surat disalin dan disiapkan untuk diekspor, respons akan menampilkan status COMPLETED beserta daftar file kotak surat terenkripsi sebagai URL HTTP. Gunakan kumpulan URL ini untuk mendownload file kotak surat.
Dapatkan file kotak surat yang didownload — Setelah mendownload file terenkripsi, dekripsi file kotak surat menggunakan kunci pribadi domain. Setelah didekripsi, file akan dilihat dalam format mbox.

Membuat kunci publik

Sebelum dapat mendownload kotak surat, Anda harus mengupload kunci enkripsi publik OpenPGP untuk domain. Langkah ini dilakukan satu kali saat menyiapkan download kotak surat. Anda dapat membuat pasangan kunci publik/pribadi menggunakan software apa pun yang kompatibel dengan OpenPGP, seperti GNU Privacy Guard (GPG). Kunci enkripsi publik ini harus berupa kunci RSA yang dienkode ASCII dalam format PGP.

Untuk membuat kunci dengan GNU Privacy Guard, ikuti langkah-langkah berikut:

Instal GnuPG 1.4.

Peringatan: GnuPG versi yang lebih baru tidak berfungsi dengan API ini.
Buat kunci baru:
```
gpg --gen-key --expert
```
Untuk menetapkan kemampuan Anda sendiri, pilih opsi 8 dan alihkan kemampuan tanda.
Untuk menyelesaikan proses pembuatan kunci, setujui semua opsi default. Kunci ini harus mengaktifkan tindakan enkripsi. Anda dapat menonaktifkan tindakan tanda tangan karena tidak digunakan.
Hanya ekspor kunci untuk ID pengguna yang sesuai dengan Google Workspace Anda:
- Jika ini pertama kalinya Anda menggunakan GPG untuk membuat kunci, ekspor satu kunci yang baru saja Anda buat:
```
gpg --armor --export
```
- Jika sudah menggunakan GPG untuk membuat kunci lain, Anda memiliki beberapa kunci di ring kunci. Mendapatkan daftar kunci:
```
gpg --list-keys
```
  Jika ada beberapa kunci yang tercantum, tentukan uid kunci yang ingin Anda ekspor:
```
gpg --armor --export KEY_UID
```
Enkode kunci dengan encoding base64 menggunakan Motobit atau alat lain. Pastikan untuk menyalin semua baris, termasuk header, dan jangan menambahkan baris tambahan. File kunci publik harus dibaca dengan set karakter US-ASCII, (nama set karakter IANA yang lebih disukai untuk ASCII).

Contoh

Contoh berikut menunjukkan cara mengonversi kunci publik menjadi string berenkode base64.

Contoh berikut adalah kunci publik sebelum konversi:

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.10 (GNU/Linux)

mQENBErWaD4BCACt2ngfs6/+QOGYbxNbc3gLnXHtqp7NTTXNW4SJo+/A1oUZoGxA
Qx6zFXhQ/8MXW66+8STS1YqNJOARFtjbIKPwjrdcukdPzYVKGZre0RaxCnMyCV+6
F4YNQD1UegHTu2wCGR1uiYOfLxUa7/do6s31WRTH8vbtiPY9/6obEIxDjDzKIqYO
rvRDWqALBYklOkJ3Hbgfyl42EsnLiAhS+dMs2PCDi2X0ZJCPZ8eTjLsdAtqVZJ+R
WC1J3UDuFfmcpsDYRtUL9w6YMtlapC+9mmJ3ABEBAAG0V0Rhc2hlciBUZXN0IChU
dGVyMkBkYXNoZXItaHlkLXRlc3QuY29tPokBOAQTAQIAIgUCStZoPgIbDQYLCQgH
k19QckTpwBdskEYumFvmWve5UX2SVV7fzOC0nZtgFxtZGlJhGmjsA3rxFTlb+Ira
WZayXCWYiCzd7m9z5/KyGD2GFTK/94mdm25N6GXh/b35pIFZXBI/rZjrYrhYRBFu
GtzGFIw9AAnFyUzEUUVfPWUtBe5yHMW54C60nHk5xYIa6qFhiLp4PYqZCrYX1iIs
fRROFA==
=STHr
-----END PGP PUBLIC KEY BLOCK-----

Contoh berikut adalah kunci publik setelah konversi:

LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv

K1FPR1lieE5iYzNnTG5YSHRxcDdOVFRYTlc0U0pvKy9BMW9VWm9HeEENClF4NnpGWG
hRLzhNWFc2Nis4U1RTMVlxTkpPQVJGdGpiSUtQd2pyZGN1a2RQellWS0dacmUwUmF4
Q25NeUNWKzYNCkY0WU5RRDFVZWdIVHUyd0NHUjF1aVlPZkx4VWE3L2RvNnMzMVdSVE
g4dmJ0aVBZOS82b2JFSXhEakR6S0lxWU8NCnJ2UkRXcUFMQllrbE9rSjNIYmdmeWw0
MkVzbkxpQWhTK2RNczJQQ0RpMlgwWkpDUFo4ZVRqTHNkQXRxVlpKK1INCldDMUozVU
R1RmZtY3BzRFlSdFVMOXc2WU10bGFwQys5bW1KM0FCRUJBQUcwVjBSaGMyaGxjaUJV
WlhOMElDaFUNCmRHVnlNa0JrWVhOb1pYSXRhSGxrTFhSbGMzUXVZMjl0UG9rQk9BUV
RBUUlBSWdVQ1N0Wm9QZ0liRFFZTENRZ0gNCmsxOVFja1Rwd0Jkc2tFWXVtRnZtV3Zl
NVVYMlNWVjdmek9DMG5adGdGeHRaR2xKaEdtanNBM3J4RlRsYitJcmENCldaYXlYQ1
dZaUN6ZDdtOXo1L0t5R0QyR0ZUSy85NG1kbTI1TjZHWGgvYjM1cElGWlhCSS9yWmpy
WXJoWVJCRnUNCkd0ekdGSXc5QUFuRnlVekVVVVZmUFdVdEJlNXlITVc1NEM2MG5Iaz
V4WUlhNnFGaGlMcDRQWXFaQ3JZWDFpSXMNCmZSUk9GQT09DQo9U1RIcg0KLS0tLS1F
TkQgUEdQIFBVQkxJQyBLRVkgQkxPQ0stLS0tLQ==

Upload kunci publik

Untuk mengupload kunci publik, buat entri XML dengan kunci publik yang dienkode base64:

<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
<apps:property name="publicKey" value="ENCODED_KEY"/>
</atom:entry>

Kirim permintaan HTTP POST ke URI feed publickey di domain Google Workspace Anda:

POST https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME

Jika berhasil, server akan menampilkan 201 CREATED status code dan respons yang mirip dengan contoh ini:

<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/publickey/DOMAIN_NAME/id>/id>
<updated>2009-04-17T15:02:45.646Z</updated>
<link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME/id'/>
<link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME/id'/>
<apps:property name='publicKey' value='ENCODED_KEY'/>
</entry>

Membuat salinan kotak surat untuk diekspor

Untuk menyiapkan salinan kotak surat pengguna untuk diekspor dan didownload, gunakan feed ekspor Email Audit API.

Kirim permintaan POST ke URI feed ekspor dan sertakan header Authorization:

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

Ganti kode berikut:

DOMAIN_NAME: nama domain Google Workspace—misalnya, contoh.com.
SOURCE_USERNAME: nama pengguna kotak surat yang ingin Anda download.

Permintaan berisi header Content-type berikut:

Content-type: application/atom+xml

Untuk mengetahui daftar lengkap parameter yang akan digunakan dalam permintaan ekspor kotak surat, lihat Resource: export.

Contoh untuk membuat kotak surat untuk ekspor

Contoh ini menggunakan parameter berikut:

Pengguna yang akan diekspor kotak suratnya adalah quinn@example.com.
beginDate adalah July 1, 2022, 04:30 hours.
endDate adalah August 30, 2022, 20:00 hours.
includeDeleted adalah false.
searchQuery adalah in:chat.
packageContent adalah FULL_MESSAGE.

Protokol

POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn

<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
   <apps:property name='beginDate' value='2022-07-01 04:30'/>
   <apps:property name='endDate' value='2022-08-30 20:00'/>
   <apps:property name='includeDeleted' value='false'/>
   <apps:property name='searchQuery' value='in:chat'/>
   <apps:property name='packageContent' value='FULL_MESSAGE'/>
</atom:entry>

Jika berhasil, server akan menampilkan kode status 201 CREATED dan entri AtomPub.

<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/export/example.com/quinn/53156>/id>
    <updated>2022-10-17T15:02:45.646Z</updated>
    <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/>
    <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/>
    <apps:property name='status' value='PENDING'/>
    <apps:property name='packageContent' value='FULL_MESSAGE'/>
    <apps:property name='includeDeleted' value='false'/>
    <apps:property name='searchQuery' value='in:chat'/>
    <apps:property name='completedDate' value='2022-09-18 10:13'/>
    <apps:property name='adminEmailAddress' value='admin1@example.com'/>
    <apps:property name='requestId' value='53156'/>
    <apps:property name='userEmailAddress' value='quinn@example.com'/>
    <apps:property name='endDate' value='2022-08-30 20:00'/>
    <apps:property name='requestDate' value='2022-09-17 12:51'/>
    <apps:property name='beginDate' value='2022-07-01 04:30'/>
</entry>

Dalam contoh ini, pemrosesan kotak surat ini telah selesai. Properti status adalah COMPLETED dan numberOfFiles yang ditampilkan untuk ekspor adalah dua.

Java

import java.util.Calendar;
import com.google.gdata.client.appsforyourdomain.audit.AuditService;
import com.google.gdata.client.appsforyourdomain.audit.MailBoxDumpRequest;
import com.google.gdata.data.appsforyourdomain.generic.GenericEntry;
...

MailBoxDumpRequest request = new MailBoxDumpRequest();
request.setAdminEmailAddress("admin@example.com");
request.setUserEmailAddress("quinn@example.com");

Calendar beginDate = Calendar.getInstance();
beginDate.set(2022, Calendar.JULY, 1, 4, 30);
request.setBeginDate(beginDate.getTime());

Calendar endDate = Calendar.getInstance();
endDate.set(2022, Calendar.AUGUST, 30, 20, 0);
request.setEndDate(endDate.getTime());

request.setIncludeDeleted(false);
request.setSearchQuery("in:chat");
request.setPackageContent("FULL_MESSAGE");

AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1");
GenericEntry mailboxDumpEntry = service.createMailboxDumpRequest(request);

String requestId = mailboxDumpEntry.getRequestId();
String status = mailboxDumpEntry.getStatus();
String numberOfFiles = mailboxDumpEntry.getNumberOfFiles();

.NET

using System;
using Google.GData.Apps;
using Google.GData.Extensions.Apps;
...

MailboxDumpRequest mailboxDumpRequest = new MailboxDumpRequest();
mailboxDumpRequest.BeginDate = new DateTime(2022, 7, 1, 4, 30, 0);
mailboxDumpRequest.EndDate = new DateTime(2022, 8, 30, 20, 0, 0);
mailboxDumpRequest.IncludeDeleted = false;
mailboxDumpRequest.SearchQuery = "in:chat";
mailboxDumpRequest.PackageContent = MonitorLevel.FULL_MESSAGE;

AuditService service = new AuditService("example.com", "example.com-auditapp-v1");
service.setUserCredentials("admin@example.com", "p@55w0rd");
MailboxDumpRequest dumpRequest = service.CreateMailboxDumpRequest("quinn", mailboxDumpRequest);

Mengambil status ekspor kotak surat

Karena persiapan ekspor kotak surat adalah proses asinkron, gunakan permintaan pengambilan ini untuk melihat apakah pemrosesan kotak surat terenkripsi telah selesai.

Untuk mengambil detail status kotak surat yang disiapkan untuk diekspor, kirim permintaan GET HTTP dengan requestId kotak surat ke URI feed ekspor dan sertakan header Authorization:

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

Ganti kode berikut:

DOMAIN_NAME: nama domain Google Workspace—misalnya, contoh.com.
SOURCE_USERNAME: nama pengguna kotak surat yang ingin Anda download.
MAILBOX_REQUESTID: requestID adalah ID unik untuk permintaan ekspor kotak surat yang ditampilkan saat ekspor pertama kali diminta.

Permintaan ini menampilkan entri AtomPub termasuk status ekspor kotak surat saat ini. Kemungkinan nilai untuk status saat ini adalah sebagai berikut:

PENDING: Permintaan sedang diproses.
ERROR: Permintaan gagal karena beberapa error. Contoh kemungkinan error adalah kunci publik API yang salah diupload untuk domain.
COMPLETED: Permintaan telah diproses sepenuhnya dan file kotak surat terenkripsi siap didownload.
MARKED_DELETE: Permintaan akan ditandai untuk dihapus saat tugas pembersihan Google dijalankan lagi. Untuk informasi selengkapnya tentang tugas pembersihan ini, lihat Menghapus kotak surat terenkripsi.
DELETED: File kotak surat berhasil dihapus menggunakan operasi Hapus kotak surat terenkripsi.
EXPIRED: File kotak surat dihapus oleh Google setelah batas retensi 3 minggu.

Contoh untuk mengambil status ekspor kotak surat

Contoh ini mengambil status kotak surat yang sesuai dengan requestIds 53156 dan 34201 untuk pengguna quinn@example.com.

Protokol

GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156

Jika berhasil, server akan menampilkan kode status 201 CREATED.

Seperti yang dapat Anda lihat dari respons berikut, statusnya adalah ERROR dan, oleh karena itu, file kotak surat terenkripsi tidak pernah dibuat.

<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/export/example.com/quinn/53156</id>
    <updated>2022-10-17T15:02:45.646Z</updated>
    <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/>
    <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156'/>
    <apps:property name='status' value='ERROR'/>
    <apps:property name='packageContent' value='FULL_MESSAGE'/>
    <apps:property name='includeDeleted' value='false'/>
    <apps:property name='searchQuery' value='in:chat'/>
    <apps:property name='completedDate' value='2022-09-18 10:13'/>
    <apps:property name='adminEmailAddress' value='admin1@example.com'/>
    <apps:property name='numberOfFiles' value='0'/>
    <apps:property name='requestId' value='53156'/>
    <apps:property name='userEmailAddress' value='quinn@example.com'/>
    <apps:property name='endDate' value='2022-08-30 20:00'/>
    <apps:property name='requestDate' value='2022-09-17 12:51'/>
    <apps:property name='beginDate' value='2022-07-01 04:30'/>
</entry>

Contoh ini mengambil status kotak surat yang sesuai dengan requestId 34201:

GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/34201

Contoh kedua ini berhasil dengan status COMPLETED. Fungsi ini menampilkan dua URL file kotak surat yang berisi file kotak surat terenkripsi, yang dapat didownload menggunakan URL di elemen fileUrl.


<entry>...
    ...
    <apps:property name='status' value='COMPLETED'/>
    <apps:property name='packageContent' value='FULL_MESSAGE'/>
    <apps:property name='completedDate' value='2022-09-18 10:13'/>
    <apps:property name='adminEmailAddress' value='admin2@example.com'/>
    <apps:property name='numberOfFiles' value='2'/>
    <apps:property name='requestId' value='34201'/>
    <apps:property name='userEmailAddress' value='namrata@example.com'/>
    <apps:property name='requestDate' value='2022-09-17 12:51'/>
    <apps:property name='fileUrl0'  value='https://apps-apis.google.com/a/data/compliance/audit/OQAAABW3Z2OlwkDFR0H5n_6lnYAzv-pWlkAlbTyAzvJEV0MC4c7lBDW' />
    <apps:property name='fileUrl1'  value='https://apps-apis.google.com/a/data/compliance/audit/OQAAABW3Z2OlwkD55nLv-pWlkAlbTyAzvJEVPnVYW45C4cC34gtyVCC' />
</entry>

Java

import com.google.gdata.client.appsforyourdomain.audit.AuditService;
import com.google.gdata.data.appsforyourdomain.generic.GenericEntry;
...

AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1");
GenericEntry mailboxDumpEntry1 = service.retrieveMailboxDumpRequest("quinn", "53156");
String status = mailboxDumpEntry1.getProperty("status"); // Status is "ERROR" if the mailbox for this request isn't created

GenericEntry mailboxDumpEntry2 = service.retrieveMailboxDumpRequest("quinn", "34201");
String status = mailboxDumpEntry2.getProperty("status");

.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");
MailboxDumpRequest mailboxDumpEntry1 = service.RetrieveMailboxDumpRequest("quinn", "53156");
RequestStatus status1 = mailboxDumpEntry1.Status; // Status is "ERROR" if the mailbox for this request isn't created

MailboxDumpRequest mailboxDumpEntry2 = service.RetrieveMailboxDumpRequest("quinn", "34201");
RequestStatus status2 = mailboxDumpEntry2.Status;

Mengambil semua permintaan status kotak surat

Untuk mengambil semua permintaan kotak surat untuk domain yang dimulai pada tanggal tertentu, buat permintaan GET HTTP ke URI feed ekspor dan sertakan header Authorization:

GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME?fromDate=FROM_DATE

Ganti kode berikut:

DOMAIN_NAME: nama domain Google Workspace—misalnya, contoh.com.
FROM_DATE: tanggal permintaan kotak surat terenkripsi yang dienkode URL dalam format Waktu Universal Terkoordinasi (UTC). Jika tidak ada fromDate yang ditentukan dalam permintaan GET ini, semua permintaan dalam tiga minggu terakhir akan diambil.

Untuk respons yang besar, setiap halaman hasil menampilkan maksimum 100 entri, dan menyertakan URI dalam tag <link rel='next'...> yang mengarah ke halaman hasil berikutnya. Saat mengembangkan aplikasi klien, kode Anda harus mengelola hasil tambahan ini.

Contoh untuk mengambil semua permintaan status kotak surat

Contoh ini mengambil semua permintaan status kotak surat untuk domain example.com yang dibuat pada atau setelah 9 PM, August 30, 2022:

Protokol

<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/export/domain</id>
    <updated>2010-03-17T15:29:21.064Z</updated>
    <link rel='next' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com?fromDate=2022-08-30%2021:00'/>
    <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com'/>
    <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com'/>
    <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/tapoloka.com?fromDate=2022-08-30%2021:00'/>
    <openSearch:startIndex>1</openSearch:startIndex>
    <entry>
        <atom:id>https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/domain/request ID</atom:id>
        <atom:updated>2022-04-17T15:29:21.064Z</atom:updated>
        <atom:link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/domain/request ID'/>
        <atom:link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/feeds/compliance/audit/mail/export/domain/request ID'/>
        <apps:property name='status' value='ERROR'/>
        <apps:property name='packageContent' value='FULL_MESSAGE'/>
        <apps:property name='includeDeleted' value='false'/>
        <apps:property name='searchQuery' value='in:chat'/>
        <apps:property name='completedDate' value='2022-09-18 10:13'/>
        <apps:property name='adminEmailAddress' value='admin1@example.com'/>
        <apps:property name='numberOfFiles' value='0'/>
        <apps:property name='requestId' value='the mailbox ID for this request'/>
   </entry>
   <entry>
        <id>>https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/domain/second request ID</id>
        ...
        <apps:property name='status' value='COMPLETED'/>
        <apps:property name='packageContent' value='FULL_MESSAGE'/>
        <apps:property name='includeDeleted' value='false'/>
        <apps:property name='completedDate' value='2022-09-18 10:13'/>
        <apps:property name='adminEmailAddress' value='admin1@example.com'/>
        <apps:property name='numberOfFiles' value='0'/>
        <apps:property name='requestId' value='the mailbox ID for this request'/>
        <apps:property name='userEmailAddress' value='quinn@example.com'/>
        <apps:property name='endDate' value='2022-08-30 20:00'/>
        <apps:property name='requestDate' value='2022-09-17 12:51'/>
        <apps:property name='beginDate' value='2022-07-01 04:30'/>
   </entry>
</feed>

Java

import java.util.Calendar;
import java.util.List;
import com.google.gdata.client.appsforyourdomain.audit.AuditService;
import com.google.gdata.client.appsforyourdomain.audit.MailBoxDumpRequest;
import com.google.gdata.data.appsforyourdomain.generic.GenericEntry;
...

AuditService service = new AuditService("admin@example.com", "p@55w0rd", "example.com", "example.com-auditapp-v1");
Calendar fromDate = Calendar.getInstance();
fromDate.set(2022, Calendar.AUGUST, 30, 21, 0);
List<GenericEntry> mailboxDumpRequestEntries = service.retrieveAllMailboxDumpRequests(fromDate.getTime());
for (GenericEntry entry : mailboxDumpRequestEntries) {
  MailBoxDumpRequest request = new MailBoxDumpRequest(entry);
  String status = request.getStatus();
}

.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<MailboxDumpRequest> dumpRequests = service.RetrieveAllMailboxDumpRequests(new DateTime(2022, 8, 30, 21, 0, 0);

Menghapus kotak surat terenkripsi

Untuk menghapus file kotak surat terenkripsi dengan status COMPLETED atau MARKED_DELETED, buat permintaan DELETE HTTP ke URI feed ekspor, termasuk requestId kotak surat dan header Authorization.

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

Ganti kode berikut:

DOMAIN_NAME: nama domain Google Workspace—misalnya, contoh.com.
SOURCE_USERNAME: nama pengguna kotak surat yang Anda download.
MAILBOX_REQUESTID: requestID adalah ID unik untuk permintaan ekspor kotak surat yang ditampilkan saat ekspor pertama kali diminta.

Jika terjadi error selama proses penghapusan, status MARKED_DELETE akan ditampilkan. Permintaan ini akan otomatis dihapus oleh tugas pembersihan Google dalam waktu 24 jam. Namun, untuk permintaan dengan status MARKED_DELETE, beberapa (atau semua) file kotak surat mungkin masih tersedia untuk didownload. Jika Anda ingin memastikan bahwa file telah dihapus, jalankan lagi operasi ini hingga status DELETED ditampilkan. Jika status MARKED_DELETE ditampilkan secara konsisten, coba lagi setelah backoff waktu eksponensial.

Contoh untuk menghapus kotak surat terenkripsi

Contoh ini menghapus kotak surat untuk pengguna quinn@example.com yang terkait dengan requestId dari 34201:

Protokol

DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/34201

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.deleteMailboxDumpRequest("quinn", "34201");

.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.DeleteMailboxDumpRequest("quinn", "34201");