Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Memigrasikan pesan email ke arsip grup Google menggunakan upload media.
Metode ini mendukung URI /upload dan menerima media yang diupload dengan karakteristik berikut:
Ukuran file maksimum: Ukuran maksimum pesan email adalah 25 MB. Batas ini meliputi header metadata, isi, dan lampiran apa pun dari pesan.
Jenis MIME Media yang diterima:message/rfc822
Batas project untuk Groups Migration API adalah 10 kueri per detik (QPS) per
akun. Permintaan API maksimum per hari adalah 500.000. Untuk informasi lebih lanjut tentang format RFC822, lihat format standar RFC822.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media
Parameter
Nama parameter
Nilai
Deskripsi
Parameter jalur
groupId
string
Alamat email grup tempat email yang dimigrasikan diarsipkan. Alamat email ini merupakan
variabel dalam jalur URL permintaan. Jika pemilik grup mengubah alamat email grup menggunakan konsol Admin atau Directory API, Anda harus menggunakan alamat email baru di variabel groupId.
Parameter kueri yang diperlukan
uploadType
string
Jenis permintaan upload ke URI /upload dengan salah satu nilai
berikut:
media - Upload sederhana yang mengupload data media.
resumable - Upload yang dapat dilanjutkan yang mengupload file dengan cara yang dapat dilanjutkan, menggunakan serangkaian minimal dua permintaan.
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
Jenis resource sisipkan ini. Nilai: groupsmigration#groups
responseCode
string
Kode status respons API untuk permintaan migrasi yang disertai dengan kode status HTTP.
Nilai status responseCode mencakup:
AUTHORIZATION FAILURE — Kredensial otorisasi administrator tidak valid. Kode status HTTP 401 ditampilkan.
BACKEND FAILURE — Server mengalami masalah atau sedang sibuk. Kode status HTTP 503
ditampilkan. Dengan menggunakan algoritme backoff eksponensial, tunggu sebentar sebelum mencoba lagi panggilan yang gagal.
INVALID MESSAGE FAILURE — Format pesan email tidak valid. Jika pesan ditolak karena format yang salah, Anda akan menerima kode status HTTP 400 Bad Request. Contoh format yang tidak valid meliputi berikut ini:
Pesan dapat memiliki kolom From, To, dan Date yang tidak ada.
Error terjadi jika baris dalam pesan tidak dihentikan oleh baris baru gaya CR+LF (yaitu, "\r\n").
Pesan email kosong.
Grup target migrasi tidak ada atau dalam mode 'hanya-baca'. Untuk informasi selengkapnya tentang mode berbagi hanya baca, lihat opsi berbagi Google Groups for Business.
SUCCESS — Email berhasil diarsipkan di arsip grup
akun. Kode status HTTP 200 ditampilkan.
UNSUPPORTED_PARALLEL_OPERATION — Groups Migration API tidak
mendukung penyisipan pesan paralel ke dalam arsip grup yang sama. Selain itu, Groups Migration API tidak mendukung permintaan batch. Namun, Groups Migration API mendukung permintaan paralel untuk penyisipan email ke dalam arsip grup yang berbeda. Kode status HTTP 400 ditampilkan.