Postfach herunterladen

Als Administrator können Sie Postfachkonten in Ihrer Domain für zu prüfen. Zur Vorbereitung eines Postfachs für den Export erstellt die Email Audit API eine verschlüsselte Kopie des Postfachs eines Nutzers. Das System gibt die URLs der die beim Herunterladen und Entschlüsseln in mbox-Format an.

Pro Tag sind maximal 100 Anfragen zum Erstellen eines Postfachexports möglich. von allen Domainadministratoren. Die Erstellung des Postfachs kann einige Zeit in Anspruch nehmen, und kann je nach Größe des Postfachs mehrere Tage dauern.

Google bewahrt die verschlüsselten Postfachdateien drei Wochen lang auf. diese Postfachdateien innerhalb dieses Zeitraums herunterladen. Danach werden sie werden gelöscht. So löschen Sie diese Postfachdateien vor Ablauf des Zeitraums: Weitere Informationen finden Sie unter Verschlüsseltes Postfach löschen.

So laden Sie ein Postfach herunter:

  • Einen öffentlichen Schlüssel generieren und hochladen: Erstellen Sie einen öffentlichen Verschlüsselungsschlüssel zum Herunterladen von Postfächern. Nur dieser Schritt einmal ausgeführt werden muss. Wenn Sie bereits einen öffentlichen Schlüssel erstellt haben, müssen Sie diesen Schritt bei jedem Export eines Postfachs ausführen.
  • Eine Exportversion des Postfachs eines Nutzers erstellen: Der Posteingangsexport beginnt, wenn Sie die Erstellung einer Kopie von in das Postfach eines Nutzers ein. Die Email Audit API authentifiziert und autorisiert Ihre Anmeldedaten und gibt eine eindeutige Anfrage-ID zurück. Erstellung des Postfachs kann zeitaufwendig sein und mehrere Tage dauern, je nachdem, wie groß Ihr Postfach ist.
  • Downloadstatus des Postfachs abrufen: Verwenden Sie die Anfrage-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 eine Status von COMPLETED zusammen mit der Liste der verschlüsselten Postfachdateien als HTTP URLs. Verwenden Sie diese URLs zum Herunterladen der Postfachdateien.
  • Heruntergeladene Postfachdateien abrufen: Führen Sie nach dem Herunterladen der verschlüsselten Dateien folgende Schritte aus: die Postfachdateien mit dem privaten Schlüssel der Domain entschlüsseln. Nach der Entschlüsselung Die Dateien werden im MBOX-Format angezeigt.

Öffentlichen Schlüssel generieren

Bevor Sie das Postfach herunterladen können, müssen Sie eine öffentliche OpenPGP-Datei hochladen. Verschlüsselungsschlüssel für die Domain. Dieser Schritt erfolgt einmal bei der Einrichtung des mailbox download herunterladen. Sie können Generieren des öffentlichen/privaten Schlüsselpaars mithilfe von OpenPGP-kompatible Software wie GNU Privacy Guard (GPG) Dieser öffentliche Verschlüsselungsschlüssel sollte ein ASCII-codierter RSA-Schlüssel im PGP-Format sein.

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

  1. Installieren Sie GnuPG 1.4.

  2. Generieren Sie einen neuen Schlüssel:

    gpg --gen-key --expert
    
  3. Wenn du deine eigenen Rechte festlegen möchtest, wähle die Option 8 aus und setze das Schild um

  4. Akzeptieren Sie alle Standardoptionen, um die Schlüsselgenerierung abzuschließen. Dieser Schlüssel sollte die Verschlüsselungsaktion aktiviert sein. Du kannst die Zeichenaktion deaktivieren weil es nicht verwendet wird.

  5. Exportieren Sie nur den Schlüssel für die User-ID, die Ihrem Google Workspace:

    • Wenn Sie GPG zum ersten Mal verwenden, um einen Schlüssel zu generieren, exportieren Sie den soeben generierten Schlüssel generiert haben:

      gpg --armor --export
      
    • Wenn Sie mit GPG bereits andere Schlüssel generiert haben, gibt es mehrere in Ihrem Schlüsselbund verwenden. Rufen Sie eine Liste der Schlüssel ab:

      gpg --list-keys
      

      Wenn mehrere Schlüssel aufgelistet sind, geben Sie die uid des Schlüssels an, den Sie die Sie exportieren möchten:

      gpg --armor --export KEY_UID
      
  6. Codieren Sie den Schlüssel mit base64-Codierung mit Motobit oder ein anderes Tool verwenden. Achten Sie darauf, dass Sie alle Zeilen, einschließlich der Kopfzeile, kopieren und keine fügen Sie zusätzliche Zeilen hinzu. Die Datei mit dem öffentlichen Schlüssel sollte mit dem Zeichensatz gelesen werden. US-ASCII (IANA bevorzugter Zeichensatzname für ASCII).

Beispiel

Das folgende Beispiel zeigt, wie Sie einen öffentlichen Schlüssel in einen base64-codierten String.

Das folgende Beispiel ist der öffentliche 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 ist der öffentliche Schlüssel nach der Konvertierung:

LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tDQpWZXJzaW9uOiBHbn
VQRyB2MS40LjEwIChHTlUvTGludXgpDQoNCm1RRU5CRXJXYUQ0QkNBQ3QybmdmczYv

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

Öffentlichen Schlüssel hochladen

  1. Erstellen Sie zum Hochladen des öffentlichen Schlüssels einen XML-Eintrag mit dem base64-codierten öffentlicher 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>
    
  2. Senden Sie eine HTTP-POST-Anfrage an den Feed-URI publickey in Ihrer Google Workspace-Domain:

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

    Bei Erfolg gibt der Server ein 201 CREATED status code und eine Antwort zurück. ähnlich wie im folgenden Beispiel:

    <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

Um eine Kopie des Postfachs eines Nutzers für den Export und Download vorzubereiten, verwenden Sie den Export -Feed der Email Audit API.

Senden Sie eine POST-Anfrage mit dem Authorization an den URI des Exportfeeds. Überschrift:

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 – für Beispiel: beispiel.de.
  • SOURCE_USERNAME: der Nutzername des Postfachs, das die 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 Postfachexportanforderung verwendet werden, 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.

<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 Die Eigenschaft status ist COMPLETED und die Für den Export zurückgegebene numberOfFiles sind 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 des Postfachexports ein asynchroner Prozess ist, sollten Sie Folgendes verwenden: Abrufanfrage, um zu sehen, ob die Verarbeitung des verschlüsselten Postfachs abgeschlossen wurde.

Senden Sie zum Abrufen von Statusdetails zu einem für den Export vorbereiteten Postfach 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 Google Workspace-Domainname – für Beispiel: beispiel.de.
  • SOURCE_USERNAME: der Nutzername des Postfachs, das die Sie herunterladen möchten.
  • MAILBOX_REQUESTID: Die requestID ist eine eindeutige Kennung der Postfachexportanfrage, die beim Export zurückgegeben wird. angefordert wird.

Diese Anfrage gibt einen AtomPub-Eintrag mit dem aktuellen Status der des Postfachexports. Für den aktuellen Status sind folgende Werte möglich:

PENDING
Die Anfrage wird bearbeitet.
ERROR
Die Anfrage ist aufgrund eines Fehlers fehlgeschlagen. Ein Beispiel für einen möglichen Fehler ist, Für die Domain wurde ein falscher öffentlicher API-Schlüssel hochgeladen.
COMPLETED
Die Anfrage wurde vollständig verarbeitet und die verschlüsselten Postfachdateien werden bereit zum Download.
MARKED_DELETE
Die Anfrage wird zum Löschen markiert, wenn der Google-Bereinigungsjob das nächste Mal ausgeführt wird. Weitere Informationen zu diesem Bereinigungsjob finden Sie unter Verschlüsseltes Postfach löschen
DELETED
Die Postfachdateien wurden mithilfe des Verschlüsseltes Postfach löschen
EXPIRED
Die Postfachdateien wurden von Google nach der Aufbewahrungsfrist von drei Wochen gelöscht.

Beispiel für das Abrufen des Exportstatus eines Postfachs

In diesem Beispiel wird der Postfachstatus abgerufen, der requestIds entspricht. 53156 und 34201 für den Nutzer quinn@example.com.

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 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 abgerufen, der der requestId 34201:

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

Dieses zweite Beispiel ist mit dem Status COMPLETED erfolgreich. Es gibt zwei Postfachdatei-URLs mit den verschlüsselten Postfachdateien zurück, was kann mithilfe der 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

So rufen Sie alle Postfachanfragen für eine Domain ab einem bestimmten Datum ab: Stellen Sie eine HTTP-GET-Anfrage an den Exportfeed-URI und fügen Sie den Parameter Authorization-Header:

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 – für Beispiel: beispiel.de.
  • FROM_DATE: das URL-codierte Datum einer verschlüsselten Datei Postfachanfrage im UTC-Format (Koordinierte Weltzeit) gesendet werden. Falls nicht: fromDate in dieser GET-Anfrage angegeben ist, werden alle Anfragen der letzten drei Wochen abgerufen werden.

Bei einer großen Antwort gibt jede Ergebnisseite maximal 100 Einträge zurück. enthält einen URI in einem <link rel='next'...>-Tag, der auf die nächste Seite von Ergebnisse. Bei der Entwicklung Ihrer Clientanwendung muss Ihr Code zu diesen zusätzlichen Ergebnissen.

Beispiel für das Abrufen aller Postfachstatusanfragen

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

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

So löschen Sie die verschlüsselten Postfachdateien mit dem Status COMPLETED oder MARKED_DELETED, senden Sie eine HTTP-DELETE-Anfrage an die Exportiere den URI des Feeds, einschließlich requestId des Postfachs und des Authorization-Header.

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 – für Beispiel: beispiel.de.
  • SOURCE_USERNAME: der Nutzername des Postfachs, das die Sie heruntergeladen haben.
  • MAILBOX_REQUESTID: Die requestID ist eine eindeutige Kennung der Postfachexportanfrage, die beim Export zurückgegeben wird. angefordert wird.

Falls während des Löschvorgangs Fehler auftreten, wird der Status Der Status MARKED_DELETE wird zurückgegeben. Diese Anfrage wird automatisch gelöscht von einem Google-Bereinigungsauftrag innerhalb von 24 Stunden. Bei einer Anfrage mit Status MARKED_DELETE, einige (oder alle) Postfachdateien sind möglicherweise noch verfügbar für herunterladen. Wenn Sie sichergehen möchten, dass die Dateien gelöscht werden, führen Sie diesen Befehl aus: Vorgang wiederholen, bis der Status DELETED zurückgegeben wird. Wenn der Status MARKED_DELETE wird konsistent zurückgegeben und der Vorgang dann nach exponentieller Zeit wiederholt Backoffs.

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

In diesem Beispiel wird das Postfach des Nutzers quinn@example.com gelöscht, der mit mit dem requestId von 34201:

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