Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Postfach herunterladen

Als Administrator können Sie Postfachkonten in Ihrer Domain zu Prüfzwecken herunterladen. Um ein Postfach für den Export vorzubereiten, erstellt die Email Audit API eine verschlüsselte Kopie des Postfachs eines Nutzers. 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 zur Erstellung von Postfachexporten beträgt insgesamt 100 Anfragen pro Tag von allen Domainadministratoren. Der Vorgang zur Erstellung von Postfächern kann zeitaufwendig sein und je nach Größe des Postfachs mehrere Tage dauern.

Google speichert die verschlüsselten Postfachdateien 3 Wochen lang. Sie sollten diese Postfachdateien also innerhalb dieses Zeitraums herunterladen. Danach werden sie gelöscht. Informationen zum Löschen dieser Postfachdateien vor Ablauf des Zeitraums finden Sie unter siehe Verschlüsseltes Postfach löschen.

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 Postfachexport ausführen.
Exportversion des Postfachs eines Nutzers erstellen — Der Postfachexportvorgang 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 Anfragen-ID zurück. Der Vorgang zur Erstellung von Postfächern kann zeitaufwendig sein und je nach Größe des Postfachs mehrere Tage dauern.
Status des Postfachdownloads abrufen: Verwenden Sie die Anfragen-ID für den Postfachexport, um den Status der ausstehenden Anfrage abzurufen. 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: Entschlüsseln Sie die Postfachdateien nach dem Herunterladen der verschlüsselten Dateien 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: Neuere Versionen von GnuPG funktionieren nicht mit dieser API.
Generieren Sie einen neuen Schlüssel:
```
gpg --gen-key --expert
```
Wenn Sie eigene Funktionen festlegen möchten, wählen Sie Option 8 aus und aktivieren Sie die Signaturfunktion.
Übernehmen Sie alle Standardoptionen, um die Schlüsselgenerierung abzuschließen. Für diesen Schlüssel muss die Verschlüsselungsaktion aktiviert sein. Sie können die Signaturaktion deaktivieren, da sie nicht verwendet wird.
Exportieren Sie nur den Schlüssel für die Nutzer-ID, die Ihrem Google Workspace-Konto entspricht:
- Wenn Sie GPG zum ersten Mal verwenden, um einen Schlüssel zu generieren, exportieren Sie den einzelnen Schlüssel, den Sie gerade generiert haben:
```
gpg --armor --export
```
- Wenn Sie GPG bereits zum Generieren anderer Schlüssel verwendet haben, befinden sich mehrere Schlüssel in Ihrem Schlüsselbund. Rufen Sie eine Liste der Schlüssel ab:
```
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 des Headers und fügen Sie keine zusätzlichen Zeilen hinzu. Die öffentliche Schlüsseldatei sollte mit dem Zeichensatz US-ASCII, (IANA bevorzugter Zeichensatzname für ASCII) gelesen werden.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie einen öffentlichen Schlüssel in einen Base64-codierten String umwandeln.

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

-----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 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 den 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 einen 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 Export-Feed der Email Audit API.

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

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. example.com.
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 Postfachexport verwendet werden können, finden Sie unter Ressourcen: export.

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

Im Beispiel werden die folgenden Parameter verwendet:

Der Nutzer, für den das Postfach exportiert werden soll, ist quinn@example.com.
beginDate ist July 1, 2022, 04:30 hours.
endDate ist August 30, 2022, 20:00 hours.
includeDeleted ist false.
searchQuery ist in:chat.
packageContent ist 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 status Eigenschaft ist COMPLETED und die numberOfFiles für den Export zurückgegebenen ist zwei.

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 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 Export-Feeds und fügen Sie den Authorization-Header 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 Google Workspace-Domainname, z. B. example.com.
SOURCE_USERNAME: der Nutzername des Postfachs, das Sie herunterladen möchten.
MAILBOX_REQUESTID: Die requestID ist eine eindeutige ID für die Anfrage zum Postfachexport, 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: Die Anfrage wird verarbeitet.
ERROR: Die Anfrage ist aufgrund eines Fehlers fehlgeschlagen. Ein Beispiel für einen möglichen Fehler ist, dass ein falscher öffentlicher API-Schlüssel für die Domain 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 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 Aufbewahrungsfrist von 3 Wochen 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 in der folgenden Antwort sehen, ist der Status ein ERROR und daher wurden die verschlüsselten Postfachdateien 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 Postfachdatei-URLs 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, senden Sie eine HTTP-GET-Anfrage an den URI des Export-Feeds 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 Google Workspace-Domainname, z. B. example.com.
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 in einem <link rel='next'...> Tag ein URI 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 Export-Feeds und fügen Sie die requestId des Postfachs und den Authorization-Header ein.

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. example.com.
SOURCE_USERNAME: der Nutzername des Postfachs, das Sie heruntergeladen haben.
MAILBOX_REQUESTID: Die requestID ist eine eindeutige ID für die Anfrage zum Postfachexport, die zurückgegeben wird, wenn der Export zum ersten Mal 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 einige (oder alle) Postfachdateien jedoch möglicherweise noch zum Download 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 MARKED_DELETE immer wieder zurückgegeben wird, versuchen Sie es nach exponentiellen Backoffs erneut.

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 der requestId 34201 zugeordnet 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