Karena Google Meet REST API adalah layanan bersama, kami menerapkan kuota dan batasan untuk memastikan REST API tersebut digunakan secara adil oleh semua pengguna dan untuk melindungi performa sistem Google Workspace secara keseluruhan.
Jika melebihi kuota, biasanya Anda akan menerima respons kode status HTTP 429: Too many requests
. Jika hal ini terjadi, Anda harus menggunakan algoritma backoff
eksponensial dan coba lagi nanti. Asalkan Anda tetap berada dalam kuota per menit, tidak ada batas jumlah permintaan yang dapat Anda buat per hari.
Tabel berikut menjelaskan batas kueri:
Quotas (Kuota) | |||||
---|---|---|---|---|---|
Permintaan baca |
|
||||
Permintaan tulis |
|
||||
Permintaan tulis yang berkurang
(Digunakan untuk permintaan |
|
Mengatasi error kuota berbasis waktu
Untuk semua error berbasis waktu (maksimum N permintaan per X menit), sebaiknya kode Anda menangkap pengecualian dan menggunakan backoff eksponensial terpotong 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, penundaan antarpermintaan harus meningkat seiring waktu hingga permintaan berhasil.
Contoh algoritma
Algoritma backoff eksponensial mencoba ulang permintaan secara eksponensial, sehingga meningkatkan waktu tunggu di antara percobaan ulang hingga waktu backoff maksimum. Contoh:
- Buat permintaan ke Google Meet API.
- Jika permintaan gagal, tunggu 1 +
random_number_milliseconds
dan coba lagi permintaan tersebut. - Jika permintaan gagal, tunggu 2 +
random_number_milliseconds
dan coba lagi permintaan tersebut. - Jika permintaan gagal, tunggu 4 +
random_number_milliseconds
dan coba lagi permintaan tersebut. - Dan seterusnya, hingga
maximum_backoff
kali. - Terus tunggu dan coba lagi hingga jumlah maksimum percobaan ulang, tetapi jangan tingkatkan periode tunggu di antara percobaan ulang.
dalam hal ini:
- Waktu tunggunya adalah
min(((2^n)+random_number_milliseconds), maximum_backoff)
, dengann
bertambah 1 untuk setiap iterasi (permintaan). random_number_milliseconds
adalah angka acak milidetik yang kurang dari atau sama dengan 1.000. Hal ini membantu menghindari kasus ketika banyak klien disinkronkan oleh beberapa situasi dan semuanya mencoba ulang sekaligus, sehingga mengirimkan permintaan dalam wave yang disinkronkan. Nilairandom_number_milliseconds
dihitung ulang setelah setiap permintaan percobaan ulang.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
dalam 64 detik, maka setelah mencapai nilai ini, klien dapat mencoba lagi setiap 64 detik. Pada titik tertentu,
klien harus dicegah agar tidak mencoba lagi tanpa batas waktu.
Waktu tunggu antara percobaan ulang dan jumlah percobaan ulang bergantung pada kasus penggunaan dan kondisi jaringan Anda.
Harga
Semua penggunaan Google Meet API tersedia tanpa biaya tambahan. Melebihi batas permintaan kuota tidak akan dikenai biaya tambahan dan akun Anda tidak akan ditagih.
Meminta penambahan kuota
Bergantung pada penggunaan resource project, Anda mungkin ingin meminta penambahan kuota. Panggilan API oleh akun layanan dianggap menggunakan satu akun. Mengajukan permohonan agar kuota ditambah tidak menjamin persetujuan. Peningkatan kuota yang besar mungkin memerlukan waktu lebih lama untuk disetujui.
Tidak semua project memiliki kuota yang sama. Seiring meningkatnya penggunaan Google Cloud dari waktu ke waktu, kuota Anda mungkin perlu ditingkatkan. Jika Anda mengharapkan 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:
- Tentang permintaan penambahan kuota
- Melihat penggunaan dan batas kuota saat ini
- Meminta batas kuota yang lebih tinggi