Sebelum memigrasikan email ke Google Grup dengan menggunakan Groups Migration API, lakukan mengikuti
- Pastikan grup target ada dan email grup akurat sebelum memigrasikan pesan email ke arsip grup tersebut. Untuk informasi selengkapnya tentang cara mencantumkan grup dan pengguna, lihat Directory API.
- Jika pengirim email memiliki domain yang sama dengan grup target, pastikan pengirim email ada sebelum memigrasikan pesan email ke arsip grup target.
- Format pesan email harus dalam
Definisi standar RFC 822.
Gunakan header
Content-type: message/rfc822
. Konfirmasikan bahwa KolomTo:
,From:
, danDate:
diformat dengan benar. Respons ditampilkan dalam format data JSON.
Memigrasi pesan email ke Google Grup
Untuk memigrasikan pesan email ke arsip grup, kirim permintaan HTTP POST
,
sertakan header Authorization
, dan ganti
GROUP_EMAIL_ADDRESS
dengan alamat email grup tempat pesan
ditujukan untuk:
POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media
Contoh permintaan
Contoh ini memigrasikan pesan email ke arsip samplegroup@googlegroups.com. Content-Length
dibatasi hingga 25 MB yang mencakup metadata, isi, dan lampiran
pesan:
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
Ganti kode berikut:
BYTES
: jumlah byte dalam email.AUTH_TOKEN
: header Authorization
.METADATA_BODY
: metadata, isi, dan lampiran email.Berikut adalah contoh pesan email dalam format teks RFC 822 yang dimigrasikan ke
arsip {i>examplegroup@googlegroups.com<i}. NNNN@mail.samplegroup.com
adalah ini
yaitu Message-ID contoh. Pengirim email yang dimigrasikan adalah contohpengirim@example.com dan emailnya adalah
dimigrasikan ke arsip grup 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.
Respons yang berhasil akan menampilkan kode status HTTP 200
dan status migrasi.
Untuk informasi selengkapnya tentang nilai responseCode
, lihat
referensi Groups Migration API.
{ "kind": "groupsMigration#groups", "responseCode": "SUCCESS", }
Melihat pesan yang diimpor di antarmuka Google Grup
Di Google Grup, status telah dibaca/belum dibaca untuk rangkaian pesan disimpan secara terpisah untuk setiap pengguna. Kapan
menyisipkan pesan dan rangkaian pesan menggunakan Groups Migration API, keduanya diperlakukan
pesan dikirim oleh pengguna di header From:
. Ini berarti bahwa mereka muncul sebagai belum dibaca
untuk semua pengguna, kecuali untuk pengguna yang alamatnya ada di header From:
. Misalnya,
setelah contoh permintaan JSON sebelumnya, pesan berjudul SUBJECT
akan muncul sebagai telah dibaca
jika samplesender@example.com
login ke Google Grup, tetapi akan muncul sebagai belum dibaca
untuk semua pengguna lain.