Batas penggunaan

Karena Google Vault API adalah layanan bersama, kami menerapkan kuota dan batasan untuk memastikan layanan ini digunakan secara adil oleh semua pengguna dan untuk melindungi kesehatan keseluruhan sistem Google Workspace.

Batas produk

Anda dapat memiliki maksimum 20 ekspor yang sedang berlangsung di seluruh organisasi Anda.

Kuota permintaan API

Setiap organisasi diizinkan melakukan 600 pembacaan matter per menit, di semua project dan pengguna, termasuk permintaan melalui Vault API dan vault.google.com.

Tabel berikut mencantumkan batas permintaan per menit per project:

Permintaan baca per menit per project
Ekspor, kasus, dan kueri tersimpan 120
Tahan 228
Operasi yang berjalan lama 300
Permintaan tulis per menit per project
Ekspor 20
Tahan 60
Izin Matter 30
Matter 60
Kueri tersimpan 45
Permintaan penelusuran (jumlah) per menit per project
Jumlah penelusuran 20

Penggunaan kuota menurut metode

Kuota yang digunakan oleh permintaan bergantung pada metode yang dipanggil. Tabel berikut mencantumkan penggunaan kuota per metode:

Metode Biaya kuota
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		1 masalah dibaca
1 masalah ditulis
matters.count 1 hitungan
matters.get 1 kasus dibaca
matters.list 10 pembacaan kasus
matters.addPermissions
matters.removePermissions 		1 kasus baca
1 kasus tulis
1 kasus tulis izin
matters.exports.create 1 ekspor dibaca
10 penulisan ekspor
matters.exports.delete 1 penulisan ekspor
matters.exports.get 1 ekspor dibaca
matters.exports.list 5 bacaan ekspor
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 masalah baca
1 masalah tulis
1 pembekuan baca
1 pembekuan tulis
matters.holds.list 1 kasus dibaca
3 pembacaan penahanan
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 masalah baca
1 masalah tulis
1 pembekuan baca
1 pembekuan tulis
matters.savedQueries.create
matters.savedQueries.delete 		1 masalah dibaca
1 masalah ditulis
1 kueri tersimpan dibaca
1 kueri tersimpan ditulis
matters.savedQueries.get 1 masalah dibaca
1 kueri tersimpan dibaca
matters.savedQueries.list 1 bacaan masalah
3 bacaan kueri tersimpan
operations.get 1 operasi yang berjalan lama dibaca

Mengatasi error kuota berbasis waktu

Jika Anda melebihi kuota per menit atau per organisasi, Anda biasanya akan mendapatkan respons kode status HTTP 429: Too many requests.

Untuk semua error berbasis waktu (maksimum N permintaan per X menit), sebaiknya kode Anda menangkap pengecualian dan menggunakan penundaan eksponensial yang dipangkas untuk memastikan perangkat Anda tidak menghasilkan beban yang berlebihan.

Backoff eksponensial adalah strategi penanganan error standar untuk aplikasi jaringan. Algoritma backoff eksponensial mencoba ulang permintaan menggunakan waktu tunggu yang meningkat secara eksponensial di antara permintaan, hingga waktu backoff maksimum. Jika permintaan masih gagal, penting agar penundaan antar-permintaan meningkat dari waktu ke waktu hingga permintaan berhasil.

Contoh algoritma

Algoritma backoff eksponensial mencoba ulang permintaan secara eksponensial, sehingga meningkatkan waktu tunggu antar-percobaan ulang hingga waktu backoff maksimum. Contoh:

  1. Buat permintaan ke Google Vault API.
  2. Jika permintaan gagal, tunggu 1 + random_number_milliseconds detik dan coba lagi permintaan tersebut.
  3. Jika permintaan gagal, tunggu 2 + random_number_milliseconds detik dan coba lagi permintaan tersebut.
  4. Jika permintaan gagal, tunggu 4 + random_number_milliseconds detik, lalu coba lagi permintaan tersebut.
  5. Dan seterusnya, hingga maximum_backoff kali.
  6. Terus tunggu dan coba ulang hingga jumlah maksimum percobaan ulang, tetapi jangan tambah waktu tunggu antar-percobaan ulang.

dalam hal ini:

  • Waktu tunggu adalah min(((2^n)+random_number_milliseconds), maximum_backoff), dengan n bertambah 1 untuk setiap iterasi (permintaan).
  • random_number_milliseconds adalah jumlah acak milidetik yang kurang dari atau sama dengan 1.000. Hal ini membantu menghindari kasus saat banyak klien disinkronkan oleh beberapa situasi dan semua mencoba lagi secara bersamaan, sehingga mengirimkan permintaan dalam gelombang yang disinkronkan. Nilai random_number_milliseconds dihitung ulang setelah setiap permintaan coba lagi.
  • maximum_backoff biasanya 32 atau 64 detik. Nilai yang sesuai bergantung pada kasus penggunaan.

Klien dapat terus mencoba ulang setelah mencapai waktu maximum_backoff. Percobaan ulang setelah tahap ini tidak perlu terus meningkatkan waktu backoff. Misalnya, jika klien menggunakan waktu maximum_backoff 64 detik, setelah mencapai nilai ini, klien dapat mencoba lagi setiap 64 detik. Pada saat tertentu, klien seharusnya dicegah untuk mencoba ulang tanpa batas waktu.

Waktu tunggu antara percobaan ulang dan jumlah percobaan ulang bergantung pada kasus penggunaan dan kondisi jaringan Anda.

Meminta penambahan kuota

Bergantung pada penggunaan resource project, Anda mungkin ingin meminta penyesuaian kuota. Panggilan API oleh akun layanan dianggap menggunakan satu akun. Mengajukan permohonan untuk penyesuaian kuota belum tentu disetujui. Permintaan penyesuaian kuota yang akan meningkatkan nilai kuota secara signifikan membutuhkan waktu lebih lama untuk disetujui.

Tidak semua project memiliki kuota yang sama. Seiring meningkatnya penggunaan Google Cloud dari waktu ke waktu, nilai kuota Anda mungkin perlu ditingkatkan. Jika Anda memperkirakan peningkatan penggunaan yang signifikan di masa mendatang, Anda dapat secara proaktif meminta penyesuaian kuota dari halaman Kuota di konsol Google Cloud.

Untuk mempelajari lebih lanjut, lihat referensi berikut:

Harga

Semua penggunaan Google Vault API tersedia tanpa biaya tambahan bagi pelanggan Google Workspace.