Archive: insert

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 pesan email maksimum adalah 25 MB. Batas ini mencakup header, isi, dan lampiran metadata 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 mengetahui informasi selengkapnya 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 adalah variabel di jalur URL permintaan. Jika pemilik grup mengubah alamat email grup baik menggunakan konsol Admin atau Directory API, Anda harus menggunakan alamat email baru dalam 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 setidaknya dua permintaan.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

Cakupan
https://www.googleapis.com/auth/apps.groups.migration

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Jangan berikan isi permintaan dengan metode ini.

Respons

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Nama properti Nilai Deskripsi
kind string Jenis resource sisipan ini. Nilai: groupsmigration#groups
responseCode string

Kode status respons API untuk permintaan migrasi yang disertai dengan kode status HTTP. Nilai status responseCode mencakup hal berikut:

AUTHORIZATION FAILURE — Kredensial otorisasi administrator tidak valid. Kode status HTTP 401 ditampilkan.

BACKEND FAILURE — Server bermasalah atau sibuk. Kode status HTTP 503 ditampilkan. Dengan menggunakan algoritma backoff eksponensial, tunggu beberapa saat sebelum mencoba kembali panggilan yang gagal.

INVALID MESSAGE FAILURE — Format pesan email tidak valid. Jika pesan menolak karena memiliki format yang salah, Anda akan menerima kode status HTTP 400 Bad Request. Contoh format yang tidak valid meliputi hal berikut:

  • Pesan mungkin tidak memiliki kolom From, To, dan Date.
  • Error akan terjadi jika baris dalam pesan tidak diakhiri dengan baris baru gaya CR+LF (yaitu, "\r\n").
  • Pesan email kosong.
  • Grup target migrasi tidak ada atau berada dalam mode 'hanya baca'. Untuk mengetahui informasi selengkapnya tentang mode berbagi hanya baca, lihat opsi berbagi Google Grup untuk Bisnis.

SUCCESS — Email berhasil diarsipkan dalam 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.