E-Mails migrieren

Bevor Sie eine E-Mail mit der Groups Migration API zu Google Groups migrieren, gehen Sie so vor:

  • Bestätigen Sie, dass die Zielgruppe vorhanden ist und die E-Mail-Adresse der Gruppe korrekt ist, bevor Sie eine E-Mail-Nachricht in das Archiv dieser Gruppe migrieren. Weitere Informationen zum Auflisten von Gruppen und Nutzern finden Sie in der Directory API.
  • Wenn der Absender der E-Mail dieselbe Domain wie die Zielgruppe hat, bestätigen Sie, dass der Absender der E-Mail vorhanden ist, bevor Sie die E-Mail-Nachricht in das Archiv der Zielgruppe migrieren.
  • Das Format der E-Mail-Nachricht muss der RFC 822-Standarddefinition entsprechen. Verwenden Sie den Header Content-type: message/rfc822. Bestätigen Sie, dass die Felder To:, From: und Date: der E-Mail-Nachricht korrekt formatiert sind. Die Antwort wird im JSON Datenformat zurückgegeben.

E-Mail-Nachricht zu Google Groups migrieren

Wenn Sie eine E-Mail-Nachricht in das Archiv einer Gruppe migrieren möchten, senden Sie eine POST HTTP-Anfrage, fügen Sie den Authorization Header ein und ersetzen Sie GROUP_EMAIL_ADDRESS durch die E-Mail-Adresse der Gruppe, für die die Nachrichten bestimmt sind:

POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media

Beispielanfrage

In diesem Beispiel werden E-Mail-Nachrichten in das Archiv von beispielgruppe@googlegroups.com migriert. Content-Length ist auf 25 MB begrenzt. Dazu gehören die Metadaten, der Text und alle Anhänge der Nachricht:

POST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer AUTH_TOKEN

METADATA_BODY

Ersetzen Sie Folgendes:

  • BYTES: die Anzahl der Byte in der E-Mail.
  • AUTH_TOKEN: der Header Authorization.
  • METADATA_BODY: die Metadaten, der Text und alle Anhänge der E-Mail.

Im Folgenden sehen Sie eine Beispiel-E-Mail-Nachricht im RFC 822-Textformat, die in das Archiv von beispielgruppe@googlegroups.com migriert wurde. Die NNNN@mail.samplegroup.com ist die Nachrichten-ID in diesem Beispiel. Der Absender der migrierten E-Mail ist beispielabsender@beispiel.com und die E-Mail wird in das Archiv der Gruppe beispielgruppe@googlegroups.com migriert:

    Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT)
    Message-ID: <NNNN@mail.samplegroup.com>
    Date: Mon, 16 Jul 2007 10:12:26 -0700
    From: samplesender@example.com
    To: samplegroup@googlegroups.com
    Subject: SUBJECT
    MIME-Version: 1.0
    Content-Type: text/plain; charset=ISO-8859-1; format=flowed
    Content-Transfer-Encoding: 7bit
    Content-Disposition: inline
    Delivered-To: samplegroup@samplegroup.com

    This is the body of the migrated email message.

Bei einer erfolgreichen Antwort wird der HTTP-Statuscode 200 und der Migrationsstatus zurückgegeben. Weitere Informationen zu responseCode Werten finden Sie unter der Referenz zur Groups Migration API.

{
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

Importierte Nachrichten in der Google Groups-Benutzeroberfläche ansehen

In Google Groups wird der Status „gelesen“ oder „ungelesen“ von Threads für jeden Nutzer separat gespeichert. Wenn Sie Nachrichten und Threads mit der Groups Migration API einfügen, werden sie so behandelt, als wären sie vom Nutzer im From: Header gesendet worden. Das bedeutet, dass sie für alle Nutzer als ungelesen angezeigt werden, mit Ausnahme des Nutzers, dessen Adresse im From: Header steht. Nach der vorherigen JSON-Anfrage wird die Nachricht mit dem Titel SUBJECT beispielsweise als gelesen angezeigt, wenn sich samplesender@example.com in Google Groups angemeldet hat. Für alle anderen Nutzer wird sie als ungelesen angezeigt.