Memigrasikan email

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

  • Pastikan bahwa grup target ada dan email grup akurat sebelum memigrasikan pesan email ke arsip grup tersebut. Untuk informasi selengkapnya tentang grup dan pengguna listingan, 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. Pastikan kolom To:, From:, dan Date: pesan email sudah 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 tujuan pesan tersebut:

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 apa pun dari 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 ID Pesan 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 nilai responseCode, lihat referensi Groups Migration API.

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

    Melihat pesan yang diimpor di antarmuka Google Grup

    Di Google Grup, status baca/belum dibaca rangkaian pesan disimpan secara terpisah untuk setiap pengguna. Saat menyisipkan pesan dan thread menggunakan Groups Migration API, pesan dan thread akan dianggap seolah-olah dikirim oleh pengguna di header From:. Artinya, status ini muncul sebagai belum dibaca oleh semua pengguna, kecuali untuk pengguna yang alamatnya ada di header From:. Misalnya, setelah contoh permintaan JSON sebelumnya, pesan berjudul SUBJECT muncul sebagai telah dibaca jika samplesender@example.com login ke Google Grup, tetapi muncul sebagai belum dibaca oleh semua pengguna lain.