Postfach herunterladen

Als Administrator können Sie Postfachkonten in Ihrer Domain zu Prüfzwecken herunterladen. Um ein Postfach für den Export vorzubereiten, wird mit der Email Audit API eine verschlüsselte Kopie des Postfachs eines Nutzers erstellt. Das System gibt die URLs für die verschlüsselten Postfachdateien zurück, die nach dem Herunterladen und Entschlüsseln im MBOX-Format verfügbar sind.

Die maximale Anzahl von Anfragen zum Erstellen von Postfachexporten pro Tag beträgt insgesamt 100 Anfragen von allen Domainadministratoren. Die Erstellung des Postfachs kann je nach Größe des Postfachs zeitaufwendig sein und mehrere Tage dauern.

Google bewahrt die verschlüsselten Postfachdateien drei Wochen lang auf. Sie sollten sie also innerhalb dieses Zeitraums herunterladen. Danach werden sie gelöscht. Wenn Sie diese Postfachdateien vor Ablauf des Zeitraums löschen möchten, finden Sie hier weitere Informationen.

So laden Sie ein Postfach herunter:

Öffentlichen Schlüssel generieren und hochladen: Erstellen Sie einen öffentlichen Verschlüsselungsschlüssel zum Herunterladen von Postfächern. 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 Postfach-Export ausführen.
Exportversion des Postfachs eines Nutzers erstellen: Der Postfachexportprozess beginnt, wenn Sie die Erstellung 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 und mehrere Tage dauern.
Status des Postfachdownloads abrufen: Mit der ID der Postfachexportanfrage können Sie den Status der ausstehenden Anfrage abrufen. Nachdem das Postfach kopiert und für den Export vorbereitet wurde, wird in der Antwort der Status COMPLETED zusammen mit der Liste der verschlüsselten Postfachdateien als HTTP-URLs zurückgegeben. Verwenden Sie diese URLs, um die Postfachdateien herunterzuladen.
Heruntergeladene Postfachdateien abrufen: Nachdem Sie die verschlüsselten Dateien heruntergeladen haben, entschlüsseln Sie die Postfachdateien 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 einmal bei der Einrichtung des Postfachdownloads ausgeführt. Sie können das öffentliche/private Schlüsselpaar mit einer beliebigen 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 :Spätere Versionen von GnuPG funktionieren nicht mit dieser API.
Neuen Schlüssel generieren:
```
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 „Sign“.
Übernehmen Sie alle Standardoptionen, um die Schlüsselgenerierung abzuschließen. Für diesen Schlüssel sollte die Aktion „Verschlüsseln“ aktiviert sein. Sie können die Sign-Aktion deaktivieren, da sie nicht verwendet wird.
Exportieren Sie nur den Schlüssel für die Nutzer-ID, die Ihrer Google Workspace-Instanz entspricht:
- Wenn Sie GPG zum ersten Mal zum Generieren eines Schlüssels verwenden, exportieren Sie den einzelnen Schlüssel, den Sie gerade generiert haben:
```
gpg --armor --export
```
- Wenn Sie bereits andere Schlüssel mit GPG generiert haben, sind mehrere Schlüssel in Ihrem Schlüsselbund vorhanden. 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 Base64-Codierung mit Motobit oder einem anderen Tool. Kopieren Sie alle Zeilen, einschließlich der Kopfzeile, und fügen Sie keine zusätzlichen Zeilen hinzu. Die Datei mit dem öffentlichen Schlüssel sollte mit dem Zeichensatz US-ASCII gelesen werden (IANA-Zeichensatzname für ASCII).

Beispiel

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

Das folgende Beispiel zeigt den öffentlichen Schlüssel vor der Konvertierung:

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

Das folgende Beispiel zeigt den öffentlichen Schlüssel nach der Konvertierung:

LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv

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

Öffentlichen Schlüssel hochladen

Um den öffentlichen Schlüssel hochzuladen, erstellen Sie 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 den publickey-Feed-URI in Ihrer Google Workspace-Domain:

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

Bei erfolgreicher Ausführung gibt der Server ein 201 CREATED status code und eine Antwort ähnlich diesem Beispiel 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/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 für den Export und Download vorbereiten möchten, verwenden Sie den Exportfeed der Email Audit API.

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

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

Ersetzen Sie Folgendes:

DOMAIN_NAME: Der Name der Google Workspace-Domain, 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 Eigenschaft 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 Prozess ist, können Sie mit dieser Abrufanfrage prüfen, ob die Verarbeitung des verschlüsselten Postfachs abgeschlossen ist.

Wenn Sie Statusdetails für ein für den Export vorbereitetes Postfach abrufen möchten, senden Sie eine HTTP-GET-Anfrage mit der requestId des Postfachs an den URI des Exportfeeds und fügen Sie den Header Authorization ein:

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

Ersetzen Sie Folgendes:

DOMAIN_NAME: Der Name der Google Workspace-Domain, 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 Exportanfrage für das Postfach, die zurückgegeben wird, wenn der Export zum ersten Mal 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: Der Antrag wird 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 öffentlicher API-Schlüssel hochgeladen wurde.
COMPLETED: Die Anfrage wurde vollständig bearbeitet 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 Bereinigungsjob finden Sie unter Verschlüsseltes Postfach löschen.
DELETED: Die Postfachdateien wurden mit dem Vorgang Verschlüsseltes Postfach löschen erfolgreich gelöscht.
EXPIRED: Die Postfachdateien wurden nach Ablauf der dreiwöchigen Aufbewahrungsfrist von Google gelöscht.

Beispiel für das Abrufen des Exportstatus eines Postfachs

In diesem Beispiel wird der Postfachstatus für die requestIds 53156 und 34201 für den Nutzer 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 der folgenden Antwort entnehmen können, ist der Status ERROR. Die verschlüsselten Postfachdateien wurden daher 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 die 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. Diese 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 Postfachanfragen für eine Domain ab einem bestimmten Datum abrufen möchten, stellen Sie eine HTTP-GET-Anfrage an den Exportfeed-URI und fügen Sie den Authorization-Header ein:

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

Ersetzen Sie Folgendes:

DOMAIN_NAME: Der Name der Google Workspace-Domain, z. B. beispiel.de.
FROM_DATE: Das URL-codierte Datum einer verschlüsselten Postfachanfrage im UTC-Format (Coordinated Universal Time). 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 ist ein URI in einem <link rel='next'...>-Tag enthalten, der auf die nächste Ergebnisseite verweist. Beim Entwickeln Ihrer Clientanwendung muss Ihr Code diese zusätzlichen Ergebnisse verarbeiten.

Beispiel für das Abrufen aller Anfragen zum Postfachstatus

In diesem Beispiel werden alle Anfragen zum Postfachstatus für die Domain example.com abgerufen, die am oder nach dem 9 PM, August 30, 2022 gestellt wurden:

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 Name der Google Workspace-Domain, z. B. beispiel.de.
SOURCE_USERNAME: Der Nutzername des heruntergeladenen Postfachs.
MAILBOX_REQUESTID: Die requestID ist eine eindeutige Kennung für die Exportanfrage für das Postfach, die zurückgegeben wird, wenn der Export zum ersten Mal angefordert wird.

Wenn während des Löschvorgangs 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 einige oder alle Postfachdateien möglicherweise weiterhin zum Herunterladen verfügbar. Wenn Sie sichergehen möchten, dass die Dateien gelöscht werden, führen Sie diesen Vorgang noch einmal aus, bis der Status DELETED zurückgegeben wird. Wenn der Status von MARKED_DELETE konsistent zurückgegeben wird, versuchen Sie es nach exponentiellen Zeit-Backoffs noch einmal.

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

Postfach herunterladen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Öffentlichen Schlüssel generieren

Beispiel

Öffentlichen Schlüssel hochladen

Kopie eines Postfachs für den Export erstellen

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

Protokoll

Java

.NET

Exportstatus eines Postfachs abrufen

Beispiel für das Abrufen des Exportstatus eines Postfachs

Protokoll

Java

.NET

Alle Anfragen zum Postfachstatus abrufen

Beispiel für das Abrufen aller Anfragen zum Postfachstatus

Protokoll

Java

.NET

Verschlüsseltes Postfach löschen

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

Protokoll

Java

.Net

Postfach herunterladen