Migracja poczty e-mail

Zanim przeprowadzisz migrację e-maila do Grup dyskusyjnych Google za pomocą interfejsu Groups Migration API:

  • Zanim przeprowadzisz migrację e-maila do archiwum grupy, sprawdź, czy grupa docelowa istnieje i czy adres e-mail grupy jest prawidłowy. Więcej informacji o wyświetlaniu grup i użytkowników znajdziesz w dokumentacji Directory API.
  • Jeśli nadawca e-maila ma tę samą domenę co grupa docelowa, przed przeprowadzeniem migracji e-maila do archiwum grupy docelowej sprawdź, czy nadawca e-maila istnieje.
  • Format e-maila musi być zgodny ze standardem RFC 822. Użyj nagłówka Content-type: message/rfc822. Sprawdź, czy pola To:, From: i Date: w e-mailu są prawidłowo sformatowane. Odpowiedź jest zwracana w formacie danych JSON.

Migracja e-maila do Grup dyskusyjnych Google

Aby przeprowadzić migrację e-maila do archiwum grupy, wyślij żądanie HTTP POST, dodaj nagłówek Authorization i zastąp GROUP_EMAIL_ADDRESS adresem e-mail grupy, do której mają trafić wiadomości:

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

Przykładowe żądanie

Ten przykład przeprowadza migrację e-maili do archiwum samplegroup@googlegroups.com. Wartość Content-Length jest ograniczona do 25 MB, co obejmuje metadane, treść i załączniki wiadomości:

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

Zastąp te elementy:

  • BYTES: liczba bajtów w e-mailu.
  • AUTH_TOKEN: nagłówek Authorization.
  • METADATA_BODY: metadane, treść i załączniki e-maila.

Poniżej znajdziesz przykładowy e-mail w formacie tekstowym RFC 822, który został przeniesiony do archiwum samplegroup@googlegroups.com. W tym przykładzie identyfikator Message-ID to NNNN@mail.samplegroup.com. Nadawcą przeniesionego e-maila jest samplesender@example.com, a e-mail jest przenoszony do archiwum grupy samplegroup@googlegroups.com:

    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.

Pomyślna odpowiedź zwraca kod stanu HTTP 200 i stan migracji. Więcej informacji o wartościach responseCode znajdziesz w dokumentacji interfejsu Groups Migration API.

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

Wyświetlanie zaimportowanych wiadomości w interfejsie Grup dyskusyjnych Google

W Grupach dyskusyjnych Google stan wątków (przeczytane lub nieprzeczytane) jest przechowywany oddzielnie dla każdego użytkownika. Podczas wstawiania wiadomości i wątków za pomocą interfejsu Groups Migration API są one traktowane tak, jakby zostały wysłane przez użytkownika w nagłówku From:. Oznacza to, że dla wszystkich użytkowników, z wyjątkiem użytkownika, którego adres znajduje się w nagłówku From:, będą one wyświetlane jako nieprzeczytane. Na przykład po wykonaniu poprzedniego przykładowego żądania JSON wiadomość o tytule SUBJECT będzie wyświetlana jako przeczytana, jeśli użytkownik samplesender@example.com zaloguje się w Grupach dyskusyjnych Google, ale dla wszystkich innych użytkowników będzie wyświetlana jako nieprzeczytana.