Migracja poczty e-mail

Zanim przeniesiesz e-maile do Grup dyskusyjnych Google przy użyciu interfejsu Groups Migration API, wykonaj te czynności:

  • Przed przeniesieniem e-maila do archiwum grupy sprawdź, czy grupa docelowa istnieje, a jej adres e-mail jest prawidłowy. Więcej informacji o grupach i użytkownikach wizytówek znajdziesz w interfejsie Directory API.
  • Jeśli nadawca e-maila ma tę samą domenę co grupa docelowa, sprawdź, czy nadawca e-maila istnieje, zanim przeniesiesz wiadomość do archiwum grupy docelowej.
  • E-mail musi być w formacie zgodnym ze standardową definicją RFC 822. Użyj nagłówka Content-type: message/rfc822. Sprawdź, czy pola To:, From: i Date: w wiadomości e-mail mają prawidłowy format. Odpowiedź jest zwracana w formacie danych JSON.

Migracja wiadomości e-mail do Grup dyskusyjnych Google

Aby przenieść e-maila do archiwum grupy, wyślij żądanie HTTP POST, dołącz nagłówek Authorization i zastąp GROUP_EMAIL_ADDRESS adresem e-mail grupy, dla której przeznaczone są wiadomości:

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

Przykładowe żądanie

Ten przykład pozwala przenieść wiadomości e-mail do archiwum przykladowagrupa@googlegroups.com. Plik Content-Length może mieć maksymalnie 25 MB, w tym metadane, treść i wszystkie załączniki:

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 następujące elementy:

  • BYTES: liczba bajtów w e-mailu.
  • AUTH_TOKEN: nagłówek Authorization.
  • METADATA_BODY: metadane, treść i załączniki e-maila.
  • Poniżej znajduje się przykładowy e-mail w formacie tekstowym w formacie RFC 822, który został przeniesiony do archiwum przykładowej grupy@googlegroups.com. NNNN@mail.samplegroup.com to w tym przykładzie identyfikator wiadomości. Nadawca przeniesionego e-maila to Sampleender@example.com, a e-mail jest przenoszony do archiwum grupy przykladowagrupa@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 przeczytanych/nieprzeczytanych wątków jest przechowywany oddzielnie dla każdego użytkownika. Gdy wstawisz wiadomości i wątki 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 są one wyświetlane jako nieprzeczytane dla wszystkich użytkowników oprócz użytkownika, którego adres znajduje się w nagłówku From:. Na przykład po poprzednim przykładowym żądaniu JSON wiadomość o nazwie SUBJECT jest wyświetlana jako przeczytana, gdy samplesender@example.com zaloguje się w Grupach dyskusyjnych Google, ale jest widoczna jako nieprzeczytana dla wszystkich innych użytkowników.