In qualità di amministratore, puoi scaricare gli account delle caselle di posta all'interno del tuo dominio per scopi di audit. Per preparare una casella di posta per l'esportazione, l'API Email Audit crea una copia criptata della casella di posta di un utente. Il sistema restituisce gli URL dei file della casella di posta criptata che, una volta scaricati e decriptati, sono disponibili in formato mbox.
Il numero massimo di richieste di creazione di esportazione della casella di posta al giorno è di 100 richieste totali da parte di tutti gli amministratori di dominio. La procedura di creazione della casella di posta può richiedere tempo e potrebbe richiedere diversi giorni a seconda delle dimensioni della casella di posta.
Google conserva i file della casella di posta criptata per 3 settimane, quindi assicurati di scaricarli entro questo periodo di tempo. Trascorso questo periodo, i file vengono eliminati. Per eliminare questi file della casella di posta prima della scadenza del periodo di tempo, consulta Eliminare una casella di posta criptata.
Per scaricare una casella di posta:
- Genera e carica una chiave pubblica — Crea una chiave di crittografia pubblica per scaricare le caselle di posta. Questo passaggio deve essere eseguito una sola volta. Se hai già creato una chiave pubblica, non devi completare questo passaggio per ogni esportazione della casella di posta.
- Crea una versione di esportazione della casella di posta di un utente — La procedura di esportazione della casella di posta inizia quando richiedi la creazione di una copia della casella di posta di un utente. L'API Email Audit autentica e autorizza le tue credenziali e restituisce un ID richiesta univoco. La procedura di creazione della casella di posta può richiedere tempo e potrebbe richiedere diversi giorni a seconda delle dimensioni della casella di posta.
- Recupera lo stato del download della casella di posta —
Utilizza l'ID richiesta di esportazione della casella di posta per ottenere lo stato della richiesta in attesa.
Una volta copiata e preparata per l'esportazione, la risposta restituisce lo stato
COMPLETEDinsieme all'elenco dei file della casella di posta criptata come URL HTTP. Utilizza questo insieme di URL per scaricare i file della casella di posta. - Ottieni i file della casella di posta scaricati: dopo aver scaricato i file criptati, decripta i file della casella di posta utilizzando la chiave privata del dominio. Una volta decriptati, i file vengono visualizzati in formato mbox.
Generare una chiave pubblica
Prima di poter scaricare la casella di posta, devi caricare una chiave di crittografia pubblica OpenPGP per il dominio. Questo passaggio viene eseguito una sola volta durante la configurazione del download della casella di posta. Puoi generare la coppia di chiavi pubblica/privata utilizzando qualsiasi software compatibile con OpenPGP, ad esempio GNU Privacy Guard (GPG). Questa chiave di crittografia pubblica deve essere una chiave RSA con codifica ASCII in formato PGP.
Per generare una chiave con GNU Privacy Guard:
Genera una nuova chiave:
gpg --gen-key --expertPer impostare le tue funzionalità, seleziona l'opzione
8e attiva/disattiva la funzionalità di firma.Per completare la procedura di generazione della chiave, accetta tutte le opzioni predefinite. Questa chiave deve avere l'azione di crittografia abilitata. Puoi disattivare l'azione di firma perché non viene utilizzata.
Esporta solo la chiave per l'ID utente corrispondente a Google Workspace:
Se è la prima volta che utilizzi GPG per generare una chiave, esporta la singola chiave che hai appena generato:
gpg --armor --exportSe hai già utilizzato GPG per generare altre chiavi, nel tuo portachiavi sono presenti più chiavi. Ottieni un elenco di chiavi:
gpg --list-keysSe sono elencate più chiavi, specifica l'
uiddella chiave che vuoi esportare:gpg --armor --export KEY_UID
Codifica la chiave con la codifica Base64 utilizzando Motobit o un altro strumento. Assicurati di copiare tutte le righe, inclusa l'intestazione, e di non aggiungere righe aggiuntive. Il file della chiave pubblica deve essere letto con il set di caratteri US-ASCII, (IANA nome del set di caratteri preferito per ASCII).
Esempio
Il seguente esempio mostra come convertire una chiave pubblica in una stringa con codifica Base64.
Il seguente esempio mostra la chiave pubblica prima della conversione:
-----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-----
Il seguente esempio mostra la chiave pubblica dopo la conversione:
LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv
K1FPR1lieE5iYzNnTG5YSHRxcDdOVFRYTlc0U0pvKy9BMW9VWm9HeEENClF4NnpGWG
hRLzhNWFc2Nis4U1RTMVlxTkpPQVJGdGpiSUtQd2pyZGN1a2RQellWS0dacmUwUmF4
Q25NeUNWKzYNCkY0WU5RRDFVZWdIVHUyd0NHUjF1aVlPZkx4VWE3L2RvNnMzMVdSVE
g4dmJ0aVBZOS82b2JFSXhEakR6S0lxWU8NCnJ2UkRXcUFMQllrbE9rSjNIYmdmeWw0
MkVzbkxpQWhTK2RNczJQQ0RpMlgwWkpDUFo4ZVRqTHNkQXRxVlpKK1INCldDMUozVU
R1RmZtY3BzRFlSdFVMOXc2WU10bGFwQys5bW1KM0FCRUJBQUcwVjBSaGMyaGxjaUJV
WlhOMElDaFUNCmRHVnlNa0JrWVhOb1pYSXRhSGxrTFhSbGMzUXVZMjl0UG9rQk9BUV
RBUUlBSWdVQ1N0Wm9QZ0liRFFZTENRZ0gNCmsxOVFja1Rwd0Jkc2tFWXVtRnZtV3Zl
NVVYMlNWVjdmek9DMG5adGdGeHRaR2xKaEdtanNBM3J4RlRsYitJcmENCldaYXlYQ1
dZaUN6ZDdtOXo1L0t5R0QyR0ZUSy85NG1kbTI1TjZHWGgvYjM1cElGWlhCSS9yWmpy
WXJoWVJCRnUNCkd0ekdGSXc5QUFuRnlVekVVVVZmUFdVdEJlNXlITVc1NEM2MG5Iaz
V4WUlhNnFGaGlMcDRQWXFaQ3JZWDFpSXMNCmZSUk9GQT09DQo9U1RIcg0KLS0tLS1F
TkQgUEdQIFBVQkxJQyBLRVkgQkxPQ0stLS0tLQ==
Caricare la chiave pubblica
Per caricare la chiave pubblica, crea una voce XML con la chiave pubblica con codifica 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>
Invia una richiesta HTTP
POSTall'URI del feedpublickeynel tuo dominio Google Workspace:POST https://apps-apis.google.com/a/feeds/compliance/audit/publickey/DOMAIN_NAME
Se l'operazione va a buon fine, il server restituisce un
201 CREATED status codee una risposta simile a questo esempio:<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>
Creare una copia di una casella di posta per l'esportazione
Per preparare una copia della casella di posta di un utente per l'esportazione e il download, utilizza il feed di esportazione dell'API Email Audit.
Invia una richiesta POST all'URI del feed di esportazione e includi l'intestazione Authorization:
POST https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME/SOURCE_USERNAME
Sostituisci quanto segue:
DOMAIN_NAME: il nome di dominio Google Workspace, ad esempio example.com.SOURCE_USERNAME: il nome utente della casella di posta che vuoi scaricare.
La richiesta contiene la seguente intestazione Content-type:
Content-type: application/atom+xml
Per un elenco completo dei parametri da utilizzare in una richiesta di esportazione della casella di posta, consulta
Risorse: export.
Esempio di creazione di una casella di posta per l'esportazione
L'esempio utilizza i seguenti parametri:
- L'utente per cui esportare la casella di posta è
quinn@example.com. - Il
beginDateèJuly 1, 2022, 04:30 hours. - Il
endDateèAugust 30, 2022, 20:00 hours. includeDeletedèfalse.searchQueryèin:chat.packageContentèFULL_MESSAGE.
Protocollo
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>
Se l'operazione va a buon fine, il server restituisce un codice di stato 201 CREATED e
una voce 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>
In questo esempio, l'elaborazione di questa casella di posta è stata completata. La proprietà status è COMPLETED e il valore di numberOfFiles restituito per l'esportazione è due.
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);
Recuperare lo stato di esportazione di una casella di posta
Poiché la preparazione dell'esportazione di una casella di posta è una procedura asincrona, utilizza questa richiesta di recupero per verificare se l'elaborazione della casella di posta criptata è stata completata.
Per recuperare i dettagli dello stato di una casella di posta preparata per l'esportazione, invia una richiesta HTTP GET con il requestId della casella di posta all'URI del feed di esportazione e includi l'intestazione Authorization:
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME/SOURCE_USERNAME/MAILBOX_REQUESTID
Sostituisci quanto segue:
DOMAIN_NAME: il nome di dominio Google Workspace, ad esempio example.com.SOURCE_USERNAME: il nome utente della casella di posta che vuoi scaricare.MAILBOX_REQUESTID: ilrequestIDè un identificatore univoco per la richiesta di esportazione della casella di posta che viene restituito quando l'esportazione viene richiesta inizialmente.
Questa richiesta restituisce una voce AtomPub che include lo stato attuale dell'esportazione della casella di posta. I valori possibili per lo stato attuale sono i seguenti:
PENDING- La richiesta è in fase di elaborazione.
ERROR- La richiesta non è andata a buon fine a causa di un errore. Un esempio di possibile errore è il caricamento di una chiave pubblica API errata per il dominio.
COMPLETED- La richiesta è stata elaborata completamente e i file della casella di posta criptata sono pronti per il download.
MARKED_DELETE- La richiesta è contrassegnata per l'eliminazione alla successiva esecuzione del job di pulizia di Google. Per saperne di più su questo job di pulizia, consulta Eliminare una casella di posta criptata.
DELETED- I file della casella di posta sono stati eliminati correttamente utilizzando l' operazione Elimina una casella di posta criptata.
EXPIRED- I file della casella di posta sono stati eliminati da Google dopo il limite di conservazione di 3 settimane.
Esempio di recupero dello stato di esportazione di una casella di posta
Questo esempio recupera lo stato della casella di posta corrispondente ai requestIds
53156 e 34201 per l'utente quinn@example.com.
Protocollo
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/53156
Se l'operazione va a buon fine, il server restituisce un codice di stato 201 CREATED.
Come puoi vedere dalla seguente risposta, lo stato è un
ERROR e, di conseguenza, i file della casella di posta criptata non sono mai stati
creati.
<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>
Questo esempio recupera lo stato della casella di posta corrispondente al requestId 34201:
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/example.com/quinn/34201
Questo secondo esempio ha esito positivo con lo stato COMPLETED. Restituisce due URL di file della casella di posta contenenti i file della casella di posta criptata, che
possono essere scaricati utilizzando gli URL negli elementi 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;
Recuperare tutte le richieste di stato della casella di posta
Per recuperare tutte le richieste della casella di posta per un dominio a partire da una data specifica, invia una richiesta HTTP GET all'URI del feed di esportazione e includi l'intestazione Authorization:
GET https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME?fromDate=FROM_DATE
Sostituisci quanto segue:
DOMAIN_NAME: il nome di dominio Google Workspace, ad esempio example.com.FROM_DATE: la data con codifica URL di una richiesta di casella di posta criptata in formato Tempo Coordinato Universale (UTC). Se non viene specificato alcunfromDatein questa richiestaGET, vengono recuperate tutte le richieste degli ultimi tre settimane.
Per una risposta di grandi dimensioni, ogni pagina di risultati restituisce un massimo di 100 voci e
include un URI in un tag <link rel='next'...> che rimanda alla pagina successiva dei
risultati. Quando sviluppi l'applicazione client, il codice deve gestire questi risultati aggiuntivi.
Esempio di recupero di tutte le richieste di stato della casella di posta
Questo esempio recupera tutte le richieste di stato della casella di posta per il dominio example.com
effettuate a partire dalle 9 PM, August 30, 2022:
Protocollo
<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);
Eliminare una casella di posta criptata
Per eliminare i file della casella di posta criptata con stato COMPLETED o
MARKED_DELETED, invia una richiesta HTTP DELETE all'
URI del feed di esportazione includendo il requestId della casella di posta e l'
Authorization intestazione.
DELETE https://apps-apis.google.com/a/feeds/compliance/audit/mail/export/DOMAIN_NAME/SOURCE_USERNAME/MAILBOX_REQUESTID
Sostituisci quanto segue:
DOMAIN_NAME: il nome di dominio Google Workspace, ad esempio example.com.SOURCE_USERNAME: il nome utente della casella di posta che hai scaricato.MAILBOX_REQUESTID: ilrequestIDè un identificatore univoco per la richiesta di esportazione della casella di posta che viene restituito quando l'esportazione viene richiesta inizialmente.
Se si verificano errori durante la procedura di eliminazione, viene restituito lo stato MARKED_DELETE. Questa richiesta verrà eliminata automaticamente da un job di pulizia di Google entro 24 ore. Tuttavia, per una richiesta con stato MARKED_DELETE, alcuni o tutti i file della casella di posta potrebbero essere ancora disponibili per il download. Se vuoi assicurarti che i file vengano eliminati, esegui di nuovo questa operazione finché non viene restituito lo stato DELETED. Se lo stato MARKED_DELETE viene restituito in modo coerente, riprova dopo i backoff esponenziali.
Esempio di eliminazione di una casella di posta criptata
Questo esempio elimina la casella di posta per l'utente quinn@example.com associata al requestId 34201:
Protocollo
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");