E-Mails migrieren

Führen Sie die folgenden Schritte aus, bevor Sie eine E-Mail mit der Groups Migration API zu Google Groups migrieren:

  • Prüfen Sie, ob die Zielgruppe existiert und die E-Mail-Adresse der Gruppe korrekt ist, bevor Sie eine an das Archiv dieser Gruppe senden. 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, prüfen Sie, ob der E-Mail-Absender existiert, bevor Sie die E-Mail in das Archiv der Zielgruppe migrieren.
  • Die E-Mail-Nachricht muss folgendes Format haben: Standarddefinition von RFC 822 Verwenden Sie den Header Content-type: message/rfc822. Prüfen Sie, ob die Die Felder To:, From: und Date: haben das richtige Format. Die Antwort wird im JSON-Datenformat zurückgegeben.

E-Mails zu Google Groups migrieren

Um eine E-Mail-Nachricht in ein Gruppenarchiv zu migrieren, senden Sie eine POST-HTTP-Anfrage, Authorization-Header einfügen und GROUP_EMAIL_ADDRESS durch die E-Mail-Adresse der Gruppe, an die die Nachrichten sind gedacht für:

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 examplegroup@googlegroups.com migriert. Die Größe von Content-Length ist auf 25 MB beschränkt. Das gilt für die Metadaten, den Textkörper 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 Authorization-Header.
  • METADATA_BODY: Metadaten, Text und Anhänge der E-Mail

    • Das folgende Beispiel zeigt eine E-Mail-Nachricht im RFC 822-Textformat, die in die -Archiv von samplegroup@googlegroups.com. Das ist NNNN@mail.samplegroup.com Nachrichten-ID des Beispiels. Der Absender der migrierten E-Mail ist musterabsender@beispiel.de und die E-Mail wird in das Archiv der Gruppe mustergruppe@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 unter Referenz zur Groups Migration API

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

    Importierte Nachrichten in der Google Groups-Benutzeroberfläche aufrufen

    In Google Groups wird der Lesestatus von Threads für jeden Nutzer separat gespeichert. Wann? Nachrichten und Threads mithilfe der Groups Migration API einfügen, Sie wurden vom Nutzer im From:-Header gesendet. Das bedeutet, dass sie für alle Nutzer als ungelesen angezeigt werden, mit Ausnahme des Nutzers, dessen Adresse in der From:-Überschrift steht. Im Beispiel für die vorherige JSON-Anfrage wird die Nachricht mit dem Titel SUBJECT beispielsweise als gelesen angezeigt, wenn sich samplesender@example.com in Google Groups angemeldet hat, aber als ungelesen für alle anderen Nutzer.