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 polaTo:
,From:
iDate:
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.