Se usó la API de Cloud Translation para traducir esta página.

Cómo descargar un buzón de correo

Como administrador, puedes descargar cuentas de buzones de correo dentro de tu dominio para fines de auditoría. A fin de preparar un buzón para exportar, la API de auditoría de correo electrónico crea una copia encriptada del buzón de un usuario. El sistema muestra las URLs de los archivos de buzón encriptados que, cuando se descargan y se desencriptan, están disponibles en formato mbox.

La cantidad máxima de solicitudes de creación de exportaciones de buzones por día es un total de 100 solicitudes de todos los administradores de dominio. El proceso de creación de los buzones puede llevar mucho tiempo y tardar varios días, según el tamaño del buzón.

Google retiene los archivos de buzones encriptados durante 3 semanas, así que asegúrate de descargar estos archivos de buzones dentro de este período. Luego, se borran. Para borrar estos archivos de buzones antes de que finalice el período, consulta Borra un buzón encriptado.

Para descargar un buzón, haz lo siguiente:

Genera y sube una clave pública: crea una clave de encriptación pública para descargar buzones. Este paso solo se debe realizar una vez. Si ya creaste una clave pública, no es necesario que completes este paso para cada exportación de buzones.
Crea una versión de exportación del buzón de un usuario: El proceso de exportación de buzones comienza cuando solicitas la creación de una copia del buzón de un usuario. La API de auditoría de correo electrónico autentica y autoriza las credenciales y muestra un ID de solicitud único. El proceso de creación de los buzones puede llevar mucho tiempo y tardar varios días, según el tamaño del buzón.
Recupera el estado de descarga de la casilla de correo: Usa el ID de solicitud de exportación de buzón para obtener el estado de la solicitud pendiente. Después de que el buzón se copie y se prepare para la exportación, la respuesta muestra un estado de COMPLETED junto con la lista de archivos de buzón encriptados como URLs HTTP. Usa este conjunto de URLs para descargar los archivos de buzones.
Obtén los archivos de buzón descargados: después de descargar los archivos encriptados, desencripta los archivos del buzón con la clave privada del dominio. Una vez desencriptados, los archivos se ven en formato mbox.

Genera una clave pública

Antes de descargar el buzón, debes subir una clave de encriptación pública de OpenPGP para el dominio. Este paso se realiza una vez durante la configuración de la descarga del buzón. Puedes generar el par de claves pública/privada mediante cualquier software compatible con OpenPGP, como GNU Privacy Guard (GPG). Esta clave de encriptación pública debe ser una clave RSA con codificación ASCII en formato PGP.

Para generar una clave con Privacy Guard de GNU, sigue estos pasos:

Instala GnuPG 1.4.

Advertencia: Las versiones posteriores de GnuPG no funcionan con esta API.
Genera una clave nueva:
```
gpg --gen-key --expert
```
Para establecer tus propias capacidades, selecciona la opción 8 y activa o desactiva la función de firma.
Para completar el proceso de generación de claves, acepta todas las opciones predeterminadas. Esta clave debe tener habilitada la acción de encriptación. Puedes desactivar la acción de firmar porque no se usa.
Solo exporta la clave para el ID de usuario que corresponda a tu Google Workspace:
- Si es la primera vez que usas GPG para generar una clave, exporta la clave única que acabas de generar:
```
gpg --armor --export
```
- Si ya usaste GPG para generar otras claves, tienes varias claves en tu llavero de claves. Obtén una lista de claves:
```
gpg --list-keys
```
  Si hay varias claves en la lista, especifica el uid de la clave que deseas exportar:
```
gpg --armor --export KEY_UID
```
Codifica la clave con codificación base64 con Motobit o alguna otra herramienta. Asegúrate de copiar todas las líneas, incluido el encabezado, y no agregues líneas adicionales. El archivo de clave pública debe leerse con el conjunto de caracteres US-ASCII (IANA, el nombre de conjunto de caracteres preferido para ASCII).

Ejemplo

En el siguiente ejemplo, se muestra cómo convertir una clave pública en una string codificada en base64.

El siguiente ejemplo es la clave pública antes de la conversión:

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

El siguiente ejemplo es la clave pública después de la conversión:

LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv

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

Sube la clave pública

Para subir la clave pública, crea una entrada XML con la clave pública codificada en 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>

Envía una solicitud POST HTTP al URI del feed publickey en tu dominio de Google Workspace:

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

Si se ejecuta de forma correcta, el servidor muestra un 201 CREATED status code y una respuesta similar a este ejemplo:

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

Crea una copia de un buzón para exportar

Si quieres preparar una copia del buzón de un usuario para su exportación y descarga, usa el feed de exportación de la API de auditoría de correo electrónico.

Envía una solicitud POST al URI del feed de exportación y, además, incluye el encabezado Authorization:

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

Reemplaza lo siguiente:

DOMAIN_NAME: Es el nombre de dominio de Google Workspace, por ejemplo, example.com.
SOURCE_USERNAME: Es el nombre de usuario del buzón que deseas descargar.

La solicitud contiene el siguiente encabezado Content-type:

Content-type: application/atom+xml

Para obtener una lista completa de los parámetros que se deben usar en una solicitud de exportación de buzones, consulta Recursos: export.

Ejemplo de cómo crear un buzón para exportar

En el ejemplo, se usan los siguientes parámetros:

El usuario para el que se exportará el buzón de correo es quinn@example.com.
La beginDate es July 1, 2022, 04:30 hours.
La endDate es August 30, 2022, 20:00 hours.
includeDeleted es false.
searchQuery es in:chat.
La packageContent es FULL_MESSAGE.

Protocolo

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>

Si se ejecuta de forma correcta, el servidor muestra un código de estado 201 CREATED y una entrada de 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>

En este ejemplo, se completó el procesamiento de este buzón. La propiedad status es COMPLETED, y el numberOfFiles que se muestra para la exportación es dos.

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);

Recupera el estado de exportación de un buzón

Debido a que la preparación de la exportación de un buzón es un proceso asíncrono, usa esta solicitud de recuperación para ver si se completó el procesamiento del buzón encriptado.

Para recuperar los detalles del estado de un buzón preparado para la exportación, envía una solicitud GET HTTP con el requestId del buzón al URI del feed de exportación y, además, incluye el encabezado Authorization:

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

Reemplaza lo siguiente:

DOMAIN_NAME: Es el nombre de dominio de Google Workspace, por ejemplo, example.com.
SOURCE_USERNAME: Es el nombre de usuario del buzón que deseas descargar.
MAILBOX_REQUESTID: requestID es un identificador único para la solicitud de exportación de buzones que se muestra cuando se solicita inicialmente la exportación.

Esta solicitud muestra una entrada de AtomPub que incluye el estado actual de la exportación del buzón. Los valores posibles para el estado actual son los siguientes:

PENDING: Se está procesando la solicitud.
ERROR: No se pudo completar la solicitud debido a un error. Un ejemplo de un posible error es que se subió una clave pública de API incorrecta para el dominio.
COMPLETED: La solicitud se procesó por completo, y los archivos de buzón encriptados están listos para descargarse.
MARKED_DELETE: La solicitud se marca para su eliminación la próxima vez que se ejecute el trabajo de limpieza de Google. Para obtener más información sobre este trabajo de limpieza, consulta Borra un buzón encriptado.
DELETED: Los archivos de buzones se borraron de forma correcta mediante la operación Borrar un buzón encriptado.
EXPIRED: Google borró los archivos de los buzones después del límite de retención de 3 semanas.

Ejemplo para recuperar el estado de exportación de un buzón

En este ejemplo, se recupera el estado del buzón correspondiente a requestIds 53156 y 34201 para el usuario quinn@example.com.

Protocolo

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

Si se ejecuta de forma correcta, el servidor muestra un código de estado 201 CREATED.

Como puedes ver en la siguiente respuesta, el estado es ERROR y, por lo tanto, los archivos de buzones encriptados nunca se crearon.

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

En este ejemplo, se recupera el estado del buzón correspondiente al 34201 de requestId:

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

Este segundo ejemplo es exitoso con un estado COMPLETED. Muestra dos URLs de archivos de buzón que contienen los archivos de buzón encriptados, que se pueden descargar con las URLs de los elementos 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;

Recuperar todas las solicitudes de estado de los buzones

Para recuperar todas las solicitudes de buzón de correo de un dominio a partir de una fecha determinada, realiza una solicitud HTTP GET al URI del feed de exportación e incluye el encabezado Authorization:

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

Reemplaza lo siguiente:

DOMAIN_NAME: Es el nombre de dominio de Google Workspace, por ejemplo, example.com.
FROM_DATE: Es la fecha codificada como URL de una solicitud encriptada de buzón en formato de hora universal coordinada (UTC). Si no se especifica un fromDate en esta solicitud GET, se recuperan todas las solicitudes de las últimas tres semanas.

Para una respuesta grande, cada página de resultados muestra un máximo de 100 entradas y, además, incluye un URI en una etiqueta <link rel='next'...> que apunta a la siguiente página de resultados. Cuando desarrollas tu aplicación cliente, tu código debe administrar estos resultados adicionales.

Ejemplo para recuperar todas las solicitudes de estado de buzón

En este ejemplo, se recuperan todas las solicitudes de estado de buzón del dominio example.com realizadas a partir del 9 PM, August 30, 2022:

Protocolo

<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);

Borra un buzón encriptado

Para borrar los archivos de buzones encriptados con un estado COMPLETED o MARKED_DELETED, realiza una solicitud HTTP DELETE al URI del feed de exportación, incluido el requestId del buzón y el encabezado Authorization.

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

Reemplaza lo siguiente:

DOMAIN_NAME: Es el nombre de dominio de Google Workspace, por ejemplo, example.com.
SOURCE_USERNAME: Es el nombre de usuario del buzón que descargaste.
MAILBOX_REQUESTID: requestID es un identificador único para la solicitud de exportación de buzones que se muestra cuando se solicita inicialmente la exportación.

Si se encuentran errores durante el proceso de eliminación, se muestra el estado MARKED_DELETE. Un trabajo de limpieza de Google borrará automáticamente esta solicitud en un plazo de 24 horas. Sin embargo, en el caso de una solicitud con el estado MARKED_DELETE, es posible que algunos (o todos) los archivos de buzones aún estén disponibles para descargar. Si deseas asegurarte de que se borren los archivos, vuelve a ejecutar esta operación hasta que se muestre el estado DELETED. Si el estado de MARKED_DELETE se muestra de manera coherente, vuelve a intentarlo después de las retiradas de tiempo exponenciales.

Ejemplo para borrar un buzón encriptado

En este ejemplo, se borra el buzón del usuario quinn@example.com asociado con el requestId de 34201:

Protocolo

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");