Batas dan kuota melindungi infrastruktur Google dari proses otomatis yang menggunakan Groups Migration API dengan cara yang tidak tepat. Permintaan yang berlebihan dari API dapat disebabkan oleh kesalahan ketik yang tidak berbahaya, atau dari sistem yang tidak dirancang secara efisien yang membuat panggilan API yang tidak perlu. Terlepas dari penyebabnya, memblokir traffic dari sumber tertentu setelah mencapai tingkat tertentu diperlukan untuk kondisi keseluruhan sistem Google Workspace.
Kegagalan permintaan API
Jika permintaan API Anda gagal, aplikasi Anda akan menerima respons kode status HTTP. Kode status HTTP 403 memiliki informasi error tentang input yang salah, dan
kode status HTTP 503 memiliki informasi error yang menunjukkan kuota API mana yang telah
dilampaui. Respons ini memungkinkan aplikasi kustom Anda mendeteksi error ini dan mengambil tindakan yang tepat.
Permintaan sensitif waktu
Jika permintaan Anda perlu diselesaikan dalam jangka waktu tertentu, kirim permintaan secara paralel atau gunakan beberapa thread di aplikasi Java atau C#. Misalnya, potong permintaan Anda berdasarkan bulan atau jangka waktu lainnya. Untuk thread, coba mulai dengan 10 thread, satu thread per permintaan. Rekomendasi thread memiliki konsekuensi dan tidak berguna untuk semua situasi API. Jika jumlah permintaan terlalu tinggi, error kuota akan terjadi.
Error berbasis waktu
Untuk semua error yang berbasis waktu (maksimum N hal selama X detik per thread), terutama
error kode status 503, sebaiknya kode Anda menangkap pengecualian tersebut dan, dengan menggunakan
algoritma
backoff eksponensial, tunggu sedikit penundaan sebelum mencoba kembali panggilan yang gagal. Contoh Groups Migration API untuk
satu thread adalah menunggu selama 5 detik dan mencoba lagi panggilan yang gagal. Jika permintaan berhasil, ulangi
pola ini untuk thread lainnya. Jika permintaan kedua tidak berhasil, aplikasi Anda harus menskalakan
kembali frekuensi permintaan hingga panggilan berhasil. Misalnya, tingkatkan penundaan
5 detik awal menjadi 10 detik dan coba lagi panggilan yang gagal. Selain itu, tentukan batas percobaan ulang. Misalnya ], coba lagi permintaan 5 hingga 7 kali dengan waktu tunda berbeda sebelum aplikasi menampilkan error kepada pengguna.
Batas
| Kategori batas API | Batas |
|---|---|
| Kueri per detik (QPS) | Batas project developer adalah 10 kueri per detik (QPS) per akun. |
Kuota
| Kategori kuota API | Kuota |
|---|---|
| Permintaan API maksimum per hari | Permintaan API maksimum per hari adalah 500.000. |
| Mengarsipkan, masa berlaku pesan | Arsip grup tidak akan habis masa berlakunya. Pesan tetap ada dalam arsip sampai grup dihapus. Kebijakan retensi email tidak memengaruhi pesan dalam arsip grup. |
| Ukuran pesan email | Ukuran maksimum pesan email adalah 25 MB. Batas ini meliputi header, isi, dan lampiran metadata pesan. |
Jenis batas lainnya
| Batasan lainnya | Batasan dan panduan |
|---|---|
| Format jenis konten | Pesan email harus dalam format teks RFC 822 standar.
Saat mengupload email yang dimigrasikan, jenis konten permintaan harus menggunakan header Content-type: message/rfc822.
|
| Format data dalam respons API | Format data respons adalah JavaScript Object Notation (JSON). |
| Kebijakan lokasi data | Groups Migration API tidak mendukung kebijakan lokasi data yang mengharuskan data disimpan dalam batas geografis atau politik tertentu karena alasan kontraktual. Jangan gunakan Groups Migration API jika lokasi data diperlukan untuk akun Anda. |
| Penyisipan pesan paralel | Groups Migration API mendukung permintaan paralel untuk penyisipan email ke dalam arsip grup yang berbeda. Namun, Groups Migration API tidak mendukung penyisipan pesan paralel ke dalam arsip grup yang sama. Selain itu, permintaan batch tidak didukung dalam versi Groups Migration API ini. |
| Permintaan tidak sah | Groups Migration API tidak menerima permintaan yang tidak sah. Permintaan dianggap tidak sah jika tidak ada token otorisasi yang diberikan. Untuk mengetahui informasi selengkapnya, lihat Mempelajari autentikasi & otorisasi. |