E-Mails migrieren

Bevor Sie eine E-Mail mithilfe der Groups Migration API zu Google Groups migrieren, führen Sie die folgenden Schritte aus:

  • Prüfen Sie, ob 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 zu Eintragsgruppen und Nutzern finden Sie in der Directory API.
  • Wenn der Absender der E-Mail dieselbe Domain wie die Zielgruppe hat, prüfen Sie, ob der E-Mail-Absender existiert, bevor Sie die E-Mail 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ätige, dass die Felder To:, From: und Date: der E-Mail-Nachricht richtig formatiert sind. Die Antwort wird im JSON-Datenformat zurückgegeben.

E-Mails zu Google Groups migrieren

Wenn Sie eine E-Mail 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 „samplegroup@googlegroups.com“ migriert. Die Datei Content-Length ist auf 25 MB beschränkt. Darin enthalten sind die Metadaten, der Nachrichtentext 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: Metadaten, Nachrichtentext und Anhänge der E-Mail

    • Die folgende Beispiel-E-Mail im RFC 822-Textformat wurde in das Archiv von samplegroup@googlegroups.com migriert. NNNN@mail.samplegroup.com ist die Nachrichten-ID dieses Beispiels. Der Absender der migrierten E-Mail ist samplesender@example.com. Die E-Mail wird in das Archiv der Gruppe samplegroup@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 werden der HTTP-Statuscode 200 und der Migrationsstatus zurückgegeben. Weitere Informationen zu responseCode-Werten finden Sie in 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 Lese-/Ungelesen-Status der Threads für jeden Nutzer separat gespeichert. Beim Einfügen von Nachrichten und Threads mit der Groups Migration API 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 sich im From:-Header befindet. Nach dem vorherigen JSON-Anfragebeispiel wird die Nachricht SUBJECT beispielsweise als gelesen angezeigt, wenn samplesender@example.com sich in Google Groups angemeldet hat. Für alle anderen Nutzer wird sie als ungelesen angezeigt.