Scaricare una casella di posta

In qualità di amministratore, puoi scaricare gli account cassetta postale 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 delle caselle di posta criptate che, una volta scaricati e decriptati, sono disponibili in formato mbox.

Il numero massimo di richieste di creazione di esportazione delle caselle di posta al giorno è di 100 richieste in totale da tutti gli amministratori di dominio. Il processo di creazione della casella di posta può richiedere molto tempo e diversi giorni, a seconda delle dimensioni della casella di posta.

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

Per scaricare una casella di posta:

  • Generare e caricare 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 è necessario completare questo passaggio per ogni esportazione della casella di posta.
  • Creazione di una versione di esportazione della casella di posta di un utente: il processo di esportazione delle caselle 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 credenziali e restituisce un ID richiesta univoco. Il processo di creazione della casella di posta può richiedere molto tempo e diversi giorni, a seconda delle dimensioni della casella di posta.
  • Recuperare lo stato di download della casella di posta: utilizza l'ID richiesta di esportazione della casella di posta per conoscere lo stato della richiesta in attesa. Dopo che la casella di posta è stata copiata e preparata per l'esportazione, la risposta restituisce lo stato COMPLETED insieme all'elenco dei file delle caselle di posta criptati come URL HTTP. Utilizza questo insieme di URL per scaricare i file delle caselle di posta.
  • Recuperare i file delle caselle di posta scaricati: dopo aver scaricato i file criptati, decripta i file delle caselle di posta 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 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 nella 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, segui questi passaggi:

  1. Installa GnuPG 1.4.

  2. Genera una nuova chiave:

    gpg --gen-key --expert

  3. Per impostare le tue funzionalità, seleziona l'opzione 8 e attiva o disattiva le funzionalità per i cartelli.

  4. Per completare il processo di generazione delle chiavi, accetta tutte le opzioni predefinite. Questa chiave deve avere l'azione di crittografia abilitata. Puoi disattivare l'azione di firma perché non è usata.

  5. Esporta solo la chiave per l'ID utente che corrisponde a Google Workspace:

    • Se è la prima volta che utilizzi GPG per generare una chiave, esporta la singola chiave che hai appena generato:

      gpg --armor --export

    • Se hai già utilizzato GPG per generare altre chiavi, il tuo keyring contiene più chiavi. Recuperare 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

  6. Codifica la chiave con codifica Base64 con Motobit o un altro strumento. Assicurati di copiare tutte le righe, inclusa l'intestazione, e di non aggiungere righe in più. 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

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

Il seguente esempio è 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 è la chiave pubblica dopo la conversione:

LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv

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

Carica la chiave pubblica

  1. 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>

  2. 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 casella 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 di Google Workspace, ad esempio example.com.
  • SOURCE_USERNAME: il nome utente della casella di posta da 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, vedi Risorse: export.

Esempio di creazione di una casella di posta per l'esportazione

L'esempio utilizza i seguenti parametri:

  • L'utente di cui vuoi 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 della casella di posta è stata completata. La proprietà status è COMPLETED e la numberOfFiles restituita 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 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 vedere se l'elaborazione della casella di posta criptata è stata completata.

Per recuperare i dettagli sullo stato di una casella di posta preparata per l'esportazione, invia una richiesta HTTP GET con il valore 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 di Google Workspace, ad esempio example.com.
  • SOURCE_USERNAME: il nome utente della casella di posta da scaricare.
  • MAILBOX_REQUESTID: requestID è un identificatore univoco per la richiesta di esportazione della casella di posta, che viene restituito al momento della richiesta iniziale dell'esportazione.

Questa richiesta restituisce una voce AtomPub con lo stato attuale dell'esportazione nella casella di posta. I possibili valori 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 alcuni errori. 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 delle caselle di posta criptati sono pronti per essere scaricati.
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, vedi Eliminare una casella di posta criptata.
DELETED
I file delle caselle di posta sono stati eliminati correttamente utilizzando l'operazione Elimina una casella di posta criptata.
EXPIRED
I file delle caselle di posta sono stati eliminati da Google dopo il limite di conservazione di 3 settimane.

Esempio di recupero dello stato dell'esportazione di una casella di posta

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 seguente risposta, lo stato è ERROR e, pertanto, i file delle caselle di posta criptati 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 a 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 uno stato COMPLETED. Restituisce due URL dei file delle caselle di posta contenenti i file delle caselle 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;

Recupera tutte le richieste relative allo stato delle caselle di posta

Per recuperare tutte le richieste di caselle di posta per un dominio a partire da una data specifica, effettua 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 di Google Workspace, ad esempio example.com.
  • FROM_DATE: la data con codifica URL di una richiesta di casella di posta criptata in formato UTC (Coordinated Universal Time). Se in questa richiesta GET non viene specificato alcun valore fromDate, tutte le richieste delle ultime tre settimane vengono recuperate.

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 dei risultati successiva. Durante lo sviluppo della tua applicazione client, il codice deve gestire questi risultati aggiuntivi.

Esempio di recupero di tutte le richieste di stato delle caselle di posta

Questo esempio recupera tutte le richieste di stato delle caselle di posta 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 delle caselle di posta criptate con stato COMPLETED o MARKED_DELETED, effettua una richiesta HTTP DELETE all'URI del feed di esportazione, inclusi requestId della casella di posta e l'intestazione 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 di Google Workspace, ad esempio example.com.
  • SOURCE_USERNAME: il nome utente della casella di posta che hai scaricato.
  • MAILBOX_REQUESTID: requestID è un identificatore univoco per la richiesta di esportazione della casella di posta, che viene restituito al momento della richiesta iniziale dell'esportazione.

Se si verificano errori durante il processo di eliminazione, viene restituito lo stato dello 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 delle caselle di posta potrebbero essere ancora disponibili per il download. Se vuoi assicurarti che i file vengano eliminati, esegui di nuovo questa operazione fino a quando non viene restituito lo stato DELETED. Se lo stato di MARKED_DELETE viene restituito in modo coerente, riprova dopo un ritorno di tempo esponenziale.

Esempio di eliminazione di una casella di posta criptata

Questo esempio elimina la casella di posta per l'utente quinn@example.com associato all'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");