Diese Seite wurde von der Cloud Translation API übersetzt.

Postfach herunterladen

Als Administrator können Sie E-Mail-Postfachkonten innerhalb Ihrer Domain zu Prüfzwecken herunterladen. Um einen Posteingang für den Export vorzubereiten, erstellt die E-Mail-Audit API eine verschlüsselte Kopie des Posteingangs eines Nutzers. Das System gibt die URLs für die verschlüsselten Mailboxdateien zurück, die nach dem Herunterladen und Entschlüsseln im MBOX-Format verfügbar sind.

Pro Tag können von allen Domainadministratoren maximal 100 Anfragen zum Erstellen von Postfachexporten gestellt werden. Die Erstellung des Postfachs kann je nach Größe einige Zeit in Anspruch nehmen.

Google speichert die verschlüsselten Postfachdateien drei Wochen lang. Sie müssen sie also innerhalb dieses Zeitraums herunterladen. Danach werden sie gelöscht. Wie Sie diese Mailboxdateien vor Ablauf des Zeitraums löschen, erfahren Sie unter Verschlüsselte Mailbox löschen.

So laden Sie einen Posteingang herunter:

Öffentlichen Schlüssel generieren und hochladen: Hiermit können Sie einen öffentlichen Verschlüsselungsschlüssel zum Herunterladen von Postfächern erstellen. Dieser Schritt muss nur einmal ausgeführt werden. Wenn Sie bereits einen öffentlichen Schlüssel erstellt haben, müssen Sie diesen Schritt nicht für jeden Postfachexport ausführen.
Exportversion des Postfachs eines Nutzers erstellen: Der Export des Postfachs beginnt, wenn Sie das Erstellen einer Kopie des Postfachs eines Nutzers anfordern. Die Email Audit API authentifiziert und autorisiert Ihre Anmeldedaten und gibt eine eindeutige Anfrage-ID zurück. Die Erstellung des Postfachs kann je nach Größe des Postfachs einige Zeit in Anspruch nehmen.
Downloadstatus des Postfachs abrufen: Mit der ID der Postfachexportanfrage können Sie den Status der ausstehenden Anfrage abrufen. Nachdem die Mailbox kopiert und für den Export vorbereitet wurde, gibt die Antwort den Status COMPLETED sowie eine Liste der verschlüsselten Mailboxdateien als HTTP-URLs zurück. Verwenden Sie diese URLs, um die Mailboxdateien herunterzuladen.
Heruntergeladene Postfachdateien abrufen: Entschlüsseln Sie die verschlüsselten Dateien nach dem Herunterladen mit dem privaten Schlüssel der Domain. Nach der Entschlüsselung werden die Dateien im MBOX-Format angezeigt.

Öffentlichen Schlüssel generieren

Bevor Sie das Postfach herunterladen können, müssen Sie einen öffentlichen OpenPGP-Verschlüsselungsschlüssel für die Domain hochladen. Dieser Schritt wird nur einmal bei der Einrichtung des Postfachdownloads ausgeführt. Sie können das öffentliche/private Schlüsselpaar mit jeder OpenPGP-kompatiblen Software wie GNU Privacy Guard (GPG) generieren. Dieser öffentliche Verschlüsselungsschlüssel sollte ein ASCII-codierter RSA-Schlüssel im PGP-Format sein.

So generieren Sie einen Schlüssel mit GNU Privacy Guard:

Installieren Sie GnuPG 1.4.

Warnung: Höhere GnuPG-Versionen funktionieren nicht mit dieser API.
So generieren Sie einen neuen Schlüssel:
```
gpg --gen-key --expert
```
Wenn Sie eigene Funktionen festlegen möchten, wählen Sie die Option 8 aus und aktivieren oder deaktivieren Sie die Funktion „Signatur“.
Akzeptieren Sie alle Standardoptionen, um die Schlüsselgenerierung abzuschließen. Für diesen Schlüssel sollte die Verschlüsselungsaktion aktiviert sein. Sie können die Aktion „Unterschreiben“ deaktivieren, da sie nicht verwendet wird.
Exportieren Sie nur den Schlüssel für die Nutzer-ID, die Ihrer Google Workspace-ID entspricht:
- Wenn Sie zum ersten Mal GPG zum Generieren eines Schlüssels verwenden, exportieren Sie den gerade generierten einzelnen Schlüssel:
```
gpg --armor --export
```
- Wenn Sie bereits mit GPG andere Schlüssel generiert haben, befinden sich mehrere Schlüssel in Ihrem Schlüsselbund. Liste mit Schlüsseln abrufen:
```
gpg --list-keys
```
  Wenn mehrere Schlüssel aufgeführt sind, geben Sie die uid des Schlüssels an, den Sie exportieren möchten:
```
gpg --armor --export KEY_UID
```
Codieren Sie den Schlüssel mit der Base64-Codierung mit Motobit oder einem anderen Tool. Achten Sie darauf, alle Zeilen einschließlich der Überschrift zu kopieren, und fügen Sie keine zusätzlichen Zeilen hinzu. Die öffentliche Schlüsseldatei sollte mit dem Zeichensatz US-ASCII gelesen werden (IANA-bevorzugter Zeichensatzname für ASCII).

Beispiel

Das folgende Beispiel zeigt, wie ein öffentlicher Schlüssel in einen base64-codierten String umgewandelt wird.

Im folgenden Beispiel ist der öffentliche Schlüssel vor der Umwandlung zu sehen:

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

Im folgenden Beispiel sehen Sie den öffentlichen Schlüssel nach der Umwandlung:

LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv

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

Öffentlichen Schlüssel hochladen

Erstellen Sie zum Hochladen des öffentlichen Schlüssels einen XML-Eintrag mit dem base64-codierten öffentlichen Schlüssel:

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

Senden Sie eine HTTP-POST-Anfrage an die publickey-Feed-URI in Ihrer Google Workspace-Domain:

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

Bei Erfolg gibt der Server eine 201 CREATED status code und eine Antwort zurück, die diesem Beispiel ähnelt:

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

Kopie eines Postfachs für den Export erstellen

Wenn Sie eine Kopie des Postfachs eines Nutzers zum Exportieren und Herunterladen vorbereiten möchten, verwenden Sie den Exportfeed der E-Mail-Audit API.

Senden Sie eine POST-Anfrage an den URI des Exportfeeds und fügen Sie den Authorization-Header hinzu:

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

Ersetzen Sie Folgendes:

DOMAIN_NAME: Der Google Workspace-Domainname, z. B. beispiel.de.
SOURCE_USERNAME: Der Nutzername des Postfachs, das Sie herunterladen möchten.

Die Anfrage enthält den folgenden Content-type-Header:

Content-type: application/atom+xml

Eine vollständige Liste der Parameter, die in einer Anfrage zum Exportieren von Postfächern verwendet werden können, finden Sie unter Ressourcen: export.

Beispiel für das Erstellen eines Postfachs für den Export

In diesem Beispiel werden die folgenden Parameter verwendet:

Der Nutzer, für den das Postfach exportiert werden soll, ist quinn@example.com.
beginDate hat den Wert „July 1, 2022, 04:30 hours“.
endDate hat den Wert „August 30, 2022, 20:00 hours“.
includeDeleted liegt bei false.
searchQuery liegt bei in:chat.
packageContent hat den Wert „FULL_MESSAGE“.

Protokoll

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>

Bei Erfolg gibt der Server den Statuscode 201 CREATED und einen AtomPub-Eintrag zurück.

<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 diesem Beispiel ist die Verarbeitung dieses Postfachs abgeschlossen. Die Property status ist COMPLETED und der für den Export zurückgegebene numberOfFiles ist „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);

Exportstatus eines Postfachs abrufen

Da die Vorbereitung eines Postfachexports ein asynchroner Vorgang ist, können Sie mit dieser Abrufanfrage prüfen, ob die Verarbeitung des verschlüsselten Postfachs abgeschlossen ist.

Wenn Sie Statusdetails für einen für den Export vorbereiteten Postkasten abrufen möchten, senden Sie eine HTTP-GET-Anfrage mit der requestId des Postfachs an den URI des Exportfeeds und fügen Sie die Kopfzeile Authorization hinzu:

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

Ersetzen Sie Folgendes:

DOMAIN_NAME: Der Google Workspace-Domainname, z. B. beispiel.de.
SOURCE_USERNAME: Der Nutzername des Postfachs, das Sie herunterladen möchten.
MAILBOX_REQUESTID: Die requestID ist eine eindeutige Kennung für die Mailboxexportanfrage, die zurückgegeben wird, wenn der Export angefordert wird.

Diese Anfrage gibt einen AtomPub-Eintrag mit dem aktuellen Status des Postfachexports zurück. Die möglichen Werte für den aktuellen Status sind:

PENDING: Die Anfrage wird gerade bearbeitet.
ERROR: Die Anfrage ist aufgrund eines Fehlers fehlgeschlagen. Ein Beispiel für einen möglichen Fehler ist, dass für die Domain ein falscher API-öffentlicher Schlüssel hochgeladen wurde.
COMPLETED: Die Anfrage wurde vollständig verarbeitet und die verschlüsselten Postfachdateien können heruntergeladen werden.
MARKED_DELETE: Die Anfrage wird beim nächsten Ausführen des Google-Bereinigungsjobs zum Löschen markiert. Weitere Informationen zu diesem Bereinigungsvorgang finden Sie unter Verschlüsseltes Postfach löschen.
DELETED: Die Mailboxdateien wurden mit dem Befehl Verschlüsselte Mailbox löschen gelöscht.
EXPIRED: Die Mailboxdateien wurden von Google nach Ablauf der Aufbewahrungsfrist von drei Wochen gelöscht.

Beispiel für das Abrufen des Exportstatus eines Postfachs

In diesem Beispiel wird der Postfachstatus für die requestIds 53156 und 34201 des Nutzers quinn@example.com abgerufen.

Protokoll

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

Bei Erfolg gibt der Server den Statuscode 201 CREATED zurück.

Wie Sie in der folgenden Antwort sehen, ist der Status ERROR. Die verschlüsselten Postfachdateien wurden also nie erstellt.

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

In diesem Beispiel wird der Postfachstatus für requestId 34201 abgerufen:

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

Dieses zweite Beispiel ist erfolgreich und hat den Status COMPLETED. Es werden zwei URLs für Postfachdateien zurückgegeben, die die verschlüsselten Postfachdateien enthalten. Sie können über die URLs in den fileUrl-Elementen heruntergeladen werden.


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

Alle Anfragen zum Postfachstatus abrufen

Wenn Sie alle Anfragen für Postfächer für eine Domain ab einem bestimmten Datum abrufen möchten, senden Sie eine HTTP-GET-Anfrage an den URI des Exportfeeds und fügen Sie den Authorization-Header hinzu:

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

Ersetzen Sie Folgendes:

DOMAIN_NAME: Der Google Workspace-Domainname, z. B. beispiel.de.
FROM_DATE: das URL-codierte Datum einer Anfrage für eine verschlüsselte Mailbox im Format der koordinierten Weltzeit (Coordinated Universal Time, UTC). Wenn in dieser GET-Anfrage kein fromDate angegeben ist, werden alle Anfragen der letzten drei Wochen abgerufen.

Bei einer großen Antwort werden auf jeder Ergebnisseite maximal 100 Einträge zurückgegeben. Außerdem enthält die Antwort einen URI in einem <link rel='next'...>-Tag, der auf die nächste Ergebnisseite verweist. Bei der Entwicklung Ihrer Clientanwendung muss Ihr Code diese zusätzlichen Ergebnisse verarbeiten.

Beispiel für das Abrufen aller Anfragen zum Mailboxstatus

In diesem Beispiel werden alle Anfragen zum Mailboxstatus für die Domain example.com ab dem 9 PM, August 30, 2022 abgerufen:

Protokoll

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

Verschlüsseltes Postfach löschen

Wenn Sie die verschlüsselten Postfachdateien mit dem Status COMPLETED oder MARKED_DELETED löschen möchten, senden Sie eine HTTP-DELETE-Anfrage an den URI des Exportfeeds, einschließlich der requestId des Postfachs und des Authorization-Headers.

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

Ersetzen Sie Folgendes:

DOMAIN_NAME: Der Google Workspace-Domainname, z. B. beispiel.de.
SOURCE_USERNAME: der Nutzername des heruntergeladenen Postfachs.
MAILBOX_REQUESTID: Die requestID ist eine eindeutige Kennung für die Mailboxexportanfrage, die zurückgegeben wird, wenn der Export angefordert wird.

Wenn beim Löschen Fehler auftreten, wird der Status MARKED_DELETE zurückgegeben. Diese Anfrage wird innerhalb von 24 Stunden automatisch von einem Google-Bereinigungsjob gelöscht. Bei einer Anfrage mit dem Status MARKED_DELETE sind jedoch möglicherweise einige oder alle Postfachdateien noch zum Herunterladen verfügbar. Wenn Sie sicher sein möchten, dass die Dateien gelöscht wurden, führen Sie diesen Vorgang so lange aus, bis der Status DELETED zurückgegeben wird. Wenn der Status von MARKED_DELETE immer wieder zurückgegeben wird, wiederholen Sie den Vorgang nach exponentiellen Backoff-Zeiten.

Beispiel für das Löschen eines verschlüsselten Postfachs

In diesem Beispiel wird das Postfach für den Nutzer quinn@example.com gelöscht, das mit der requestId von 34201 verknüpft ist:

Protokoll

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