Memigrasikan email

Sebelum memigrasikan email ke Google Grup menggunakan Groups Migration API, lakukan hal berikut:

  • Pastikan grup target ada dan email grup akurat sebelum memigrasikan pesan email ke arsip grup tersebut. Untuk mengetahui 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 sesuai dengan definisi standar RFC 822. Gunakan header Content-type: message/rfc822. Pastikan kolom To:, From:, dan Date: pesan email diformat dengan benar. Respons ditampilkan dalam format data JSON.

Memigrasikan 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 yang dituju pesan:

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 samplegroup@googlegroups.com. NNNN@mail.samplegroup.com adalah Message-ID contoh ini. Pengirim email yang dimigrasikan adalah samplesender@example.com dan email 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 responseCode nilai, lihat referensi API Migrasi Grup.

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

Melihat pesan yang diimpor di antarmuka Google Grup

Di Google Grup, status baca atau belum dibaca thread disimpan secara terpisah untuk setiap pengguna. Saat pesan dan thread disisipkan menggunakan Groups Migration API, pesan dan thread tersebut diperlakukan seolah-olah dikirim oleh pengguna di header From:. Artinya, pesan dan thread tersebut akan muncul sebagai belum dibaca untuk semua pengguna, kecuali 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 lainnya.