Questa pagina è stata tradotta dall'API Cloud Translation.

Scaricare una casella di posta

In qualità di amministratore, puoi scaricare gli account delle caselle di posta all'interno del tuo dominio per scopi di controllo. 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 posta in arrivo criptati che, una volta scaricati e decriptati, sono disponibili in formato mbox.

Il numero massimo di richieste di creazione di esportazioni della cassetta postale al giorno è pari a un totale di 100 richieste da parte di tutti gli amministratori di dominio. La procedura di creazione della casella di posta può richiedere molto tempo e potrebbe durare diversi giorni, a seconda delle dimensioni della casella di posta.

Google conserva i file delle caselle di posta criptate per 3 settimane, quindi assicurati di scaricarli entro questo periodo di tempo. Trascorso questo periodo, vengono eliminati. Per eliminare questi file della cassetta postale prima della scadenza del periodo di tempo, consulta Eliminare una cassetta postale criptata.

Per scaricare una cassetta postale:

Genera e carica una chiave pubblica: crea una chiave di crittografia pubblica per il download delle caselle di posta. Questo passaggio deve essere eseguito solo una volta. Se hai già creato una chiave pubblica, non è necessario completare questo passaggio per ogni esportazione della cassetta postale.
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. Il processo di creazione della casella di posta può richiedere molto tempo e potrebbe durare diversi giorni, a seconda delle dimensioni della casella di posta.
Recupero dello 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. Dopo che la cassetta postale è stata copiata e preparata per l'esportazione, la risposta restituisce lo stato COMPLETED insieme all'elenco dei file della cassetta postale criptati come URL HTTP. Utilizza questo insieme di URL per scaricare i file della cassetta postale.
Recupera i file della cassetta postale scaricati: dopo aver scaricato i file criptati, decripta i file della cassetta postale utilizzando la chiave privata del dominio. Una volta decriptati, i file vengono visualizzati in formato mbox.

Genera una chiave pubblica

Prima di poter scaricare la cassetta postale, devi caricare una chiave di crittografia pubblica OpenPGP per il dominio. Questo passaggio viene eseguito una 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 codificata in ASCII in formato PGP.

Per generare una chiave con GNU Privacy Guard:

Installa GnuPG 1.4.

Avviso: le versioni successive di GnuPG non funzionano con questa API.
Genera una nuova chiave:
```
gpg --gen-key --expert
```
Per impostare le tue autorizzazioni, seleziona l'opzione 8 e attiva/disattiva l'autorizzazione di firma.
Per completare la procedura di generazione della chiave, accetta tutte le opzioni predefinite. Per questa chiave deve essere attivata l'azione di crittografia. Puoi disattivare l'azione di firma perché non viene utilizzata.
Esporta solo la chiave per l'ID utente corrispondente al tuo Google Workspace:
- Se è la prima volta che utilizzi GPG per generare una chiave, esporta la singola chiave appena generata:
```
gpg --armor --export
```
- Se hai già utilizzato GPG per generare altre chiavi, hai più chiavi nel tuo portachiavi. Recupera un elenco di chiavi:
```
gpg --list-keys
```
  Se sono elencate più chiavi, specifica il uid della chiave che vuoi esportare:
```
gpg --armor --export KEY_UID
```
Codifica la chiave con la codifica Base64 con Motobit o con 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 charset US-ASCII, (nome del charset preferito dall'IANA per ASCII).

Esempio

L'esempio seguente mostra come convertire una chiave pubblica in una stringa con codifica base64.

L'esempio seguente 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-----

Di seguito è riportato l'esempio della chiave pubblica dopo la conversione:

LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv

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

Carica 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 POST all'URI del feed publickey nel tuo dominio Google Workspace:

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

In caso di esito positivo, il server restituisce un 201 CREATED status code e 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 cassetta di posta di un utente da esportare e scaricare, 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 cassetta postale 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 valore beginDate è July 1, 2022, 04:30 hours.
Il valore endDate è August 30, 2022, 20:00 hours.
includeDeleted è false.
searchQuery è in:chat.
Il valore 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>

In caso di esito positivo, 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 cassetta postale è stata completata. La proprietà status è COMPLETED e il valore numberOfFiles restituito per l'esportazione è 2.

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 dell'esportazione di una casella di posta

Poiché la preparazione dell'esportazione di una casella di posta è un processo asincrono, 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 cassetta postale preparata per l'esportazione, invia una richiesta HTTPGET con il requestId della cassetta postale all'URI del feed di esportazione e includere 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 cassetta postale che vuoi scaricare.
MAILBOX_REQUESTID: requestID è un identificatore unico per la richiesta di esportazione della cassetta di posta restituito quando viene inizialmente richiesta l'esportazione.

Questa richiesta restituisce una voce AtomPub che include lo stato corrente dell'esportazione della posta in arrivo. I valori possibili per lo stato corrente sono:

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 è che è stata caricata una chiave pubblica API errata per il dominio.
COMPLETED: La richiesta è stata elaborata completamente e i file della cassetta di posta criptata sono pronti per il download.
MARKED_DELETE: La richiesta viene contrassegnata per l'eliminazione alla successiva esecuzione del job di pulizia di Google. Per ulteriori informazioni su questo job di pulizia, consulta Eliminare una casella di posta criptata.
DELETED: I file della cassetta postale sono stati eliminati correttamente utilizzando l'operazione Elimina una cassetta postale criptata.
EXPIRED: I file della cassetta postale sono stati eliminati da Google dopo il limite di conservazione di 3 settimane.

Esempio per recuperare lo stato dell'esportazione di una cassetta postale

Questo esempio recupera lo stato della casella di posta corrispondente a 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

In caso di esito positivo, il server restituisce un codice di stato 201 CREATED.

Come puoi vedere dalla risposta che segue, lo stato è ERROR e, pertanto, i file della cassetta 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 cassetta postale corrispondente a requestId 34201:

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

Questo secondo esempio è riuscito con uno stato COMPLETED. Restituisce due URL dei file della cassetta di posta contenenti i file della cassetta di posta criptati, 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 relative allo stato della casella di posta

Per recuperare tutte le richieste di caselle di posta per un dominio a partire da una determinata data, invia una richiesta GET HTTP all'URI del feed di esportazione e includi l'Authorization intestazione:

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 codificata in URL di una richiesta della posta in arrivo criptata in formato UTC (Tempo Universale Coordinato). Se non viene specificato alcun fromDate in questa richiesta GET, vengono recuperate tutte le richieste delle ultime 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 di risultati successiva. Quando sviluppi l'applicazione client, il codice deve gestire questi risultati aggiuntivi.

Esempio per il recupero di tutte le richieste relative allo stato della cassetta postale

Questo esempio recupera tutte le richieste relative allo stato della cassetta postale per il dominio example.com effettuate a partire dal giorno 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 cassetta di posta criptata con stato COMPLETED o MARKED_DELETED, invia una richiesta HTTP DELETE all'URI del feed di esportazione, includendo il requestId della cassetta di posta e l'Authorization.

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 cassetta postale che hai scaricato.
MAILBOX_REQUESTID: requestID è un identificatore unico per la richiesta di esportazione della cassetta di posta restituito quando viene inizialmente richiesta l'esportazione.

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 statoMARKED_DELETE, alcuni (o tutti) i file della cassetta 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 di MARKED_DELETE viene restituito in modo coerente, riprova dopo intervalli di tempo con backoff esponenziali.

Esempio per l'eliminazione di una casella di posta criptata

Questo esempio elimina la casella di posta dell'utente quinn@example.com associata al requestId di 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");