Sebelum memigrasikan email ke Google Grup dengan menggunakan Groups Migration API, lakukan mengikuti
- Pastikan bahwa grup target ada dan email grup tersebut sudah akurat sebelum memigrasikan pesan email ke arsip grup tersebut. Untuk informasi selengkapnya tentang grup listingan dan pengguna, lihat tindakan 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. Tujuan ditampilkan di kolom JSON format data.
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. Tujuan
Content-Length
dibatasi hingga 25 MB yang mencakup metadata, isi, dan setiap pesan
lampiran:
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 mengetahui informasi selengkapnya tentang nilai responseCode
, lihat
referensi Groups Migration API.
{ "kind": "groupsMigration#groups", "responseCode": "SUCCESS", }
Lihat pesan yang diimpor di antarmuka Google Grup
Di Google Grup, rangkaian pesan status baca/belum dibaca 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
masuk ke Google Grup, tetapi ditampilkan sebagai belum dibaca
untuk semua pengguna lain.