Scaricare una casella di posta

In qualità di amministratore, puoi scaricare gli account casella postale all'interno del tuo dominio per scopi di audit. Per preparare una casella postale all'esportazione, l'API Email Audit crea una copia criptata della casella postale di un utente. Il sistema restituisce gli URL dei file della casella postale criptati che, una volta scaricati e decriptati, sono disponibili in formato mbox.

Il numero massimo di richieste di creazione di esportazione delle caselle postali al giorno è di 100 richieste da tutti gli amministratori di dominio. 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.

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

Per scaricare una casella postale:

Genera e carica una chiave pubblica: crea una chiave di crittografia pubblica per scaricare le caselle postali. Questo passaggio deve essere eseguito una sola volta. Se hai già creato una chiave pubblica, non devi completare questo passaggio per ogni esportazione di casella postale.
Crea una versione di esportazione della casella postale di un utente: il processo di esportazione della casella postale inizia quando richiedi la creazione di una copia della casella postale 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 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 COMPLETED insieme all'elenco dei file della casella postale criptati come URL HTTP. Utilizza questo insieme di URL per scaricare i file della casella postale.
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 postale, 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:

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 funzionalità, seleziona l'opzione 8 e attiva/disattiva la funzionalità del segno.
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 segno 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 che hai appena generato:
```
gpg --armor --export
```
- Se hai già utilizzato GPG per generare altre chiavi, hai più chiavi nel tuo keyring. 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 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 codificata in 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==

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

Se l'operazione ha 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 da esportare

Per preparare una copia della casella postale 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 del 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 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>

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 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 di esportazione di una casella postale

Poiché la preparazione dell'esportazione di una casella postale è un processo asincrono, utilizza questa richiesta di recupero per verificare se l'elaborazione della casella postale criptata è stata completata.

Per recuperare i dettagli dello stato di una casella di posta preparata per l'esportazione, invia una richiesta HTTP GET con l'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 del dominio Google Workspace, ad esempio example.com.
SOURCE_USERNAME: il nome utente della casella di posta che vuoi scaricare.
MAILBOX_REQUESTID: il requestID è un identificatore univoco per la richiesta di esportazione della casella postale restituito quando l'esportazione viene richiesta inizialmente.

Questa richiesta restituisce una voce AtomPub che include lo stato attuale dell'esportazione della casella postale. I valori possibili per lo stato attuale 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 casella di posta criptati sono pronti per il download.
MARKED_DELETE: La richiesta viene contrassegnata per l'eliminazione al successivo avvio del job di pulizia di Google. Per saperne di più su questo processo di pulizia, vedi Eliminare una casella di posta criptata.
DELETED: I file della casella postale sono stati eliminati correttamente utilizzando l'operazione Elimina una casella postale criptata.
EXPIRED: I file della casella postale sono stati eliminati da Google dopo il limite di conservazione di 3 settimane.

Esempio di recupero dello stato di esportazione di una casella 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 seguente risposta, lo stato è ERROR e, pertanto, i file della mailbox 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 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 lo stato COMPLETED. Restituisce due URL di file di casella postale contenenti i file di casella postale 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 di stato della casella postale

Per recuperare tutte le richieste di casella postale per un dominio a partire da una determinata data, 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 del dominio Google Workspace, ad esempio example.com.
FROM_DATE: la data codificata in formato URL di una richiesta di casella postale criptata nel formato Tempo Universale Coordinato (UTC). 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 successiva di risultati. Quando sviluppi l'applicazione client, il codice deve gestire questi risultati aggiuntivi.

Esempio per il recupero di tutte le richieste di stato delle caselle postali

Questo esempio recupera tutte le richieste di stato delle caselle postali 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 casella postale criptati con stato COMPLETED o MARKED_DELETED, invia una richiesta HTTP DELETE all'URI del feed di esportazione, incluso l'requestId della casella postale 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 del dominio Google Workspace, ad esempio example.com.
SOURCE_USERNAME: il nome utente della casella di posta che hai scaricato.
MAILBOX_REQUESTID: il requestID è un identificatore univoco per la richiesta di esportazione della casella postale 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 processo 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 di 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 dell'utente quinn@example.com associato 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");

Scaricare una casella di posta Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Generare una chiave pubblica

Esempio

Carica la chiave pubblica

Creare una copia di una casella di posta da esportare

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

Protocollo

Java

.NET

Recuperare lo stato di esportazione di una casella postale

Esempio di recupero dello stato di esportazione di una casella postale

Protocollo

Java

.NET

Recuperare tutte le richieste di stato della casella postale

Esempio per il recupero di tutte le richieste di stato delle caselle postali

Protocollo

Java

.NET

Eliminare una casella di posta criptata

Esempio di eliminazione di una casella di posta criptata

Protocollo

Java

.Net

Scaricare una casella di posta