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 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:

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

Untuk 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 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.