Membatasi penggunaan API

Bergantung pada API, Anda dapat membatasi permintaan secara eksplisit dengan membatasi permintaan per hari, permintaan per menit, atau permintaan per menit per pengguna.

Anda mungkin ingin membatasi penggunaan yang dapat ditagih dengan menetapkan batas. Misalnya, untuk mencegah tagihan atas penggunaan di luar batas penggunaan gratis, Anda dapat menetapkan batas permintaan per hari.

Penting: Batas kuota tidak selalu sepenuhnya akurat, karena ada beberapa latensi antara saat kuota terlampaui dan saat penerapan dimulai. Saat menggunakan kuota sebagai alat untuk membatasi penagihan, izinkan beberapa buffering.

Melihat dan mengubah batas jumlah permintaan

Anda dapat menetapkan batas untuk semua permintaan ke API yang dapat ditagih. Sebagian besar API menetapkan batas default, tetapi Anda dapat mengubah batas tersebut hingga maksimum yang ditentukan oleh Google. Beberapa API menetapkan batas yang rendah hingga Anda mengaktifkan penagihan di project.

Untuk melihat atau mengubah batas untuk API Anda, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Dasbor Layanan & API.

   Buka Dashboard API & Layanan

2. Dari daftar project, pilih project atau buat project baru.
3. Klik nama API yang Anda minati.
4. Klik Kuota. Jika tab Kuota tidak ada di navigasi tab, artinya API yang Anda pilih tidak memiliki kuota yang ditentukan.
5. Untuk menemukan kuota yang ingin Anda batasi, masukkan properti dan nilai yang sesuai di kolom Filter . Misalnya, untuk menemukan kuota Subnetworks, masukkan Quota:Subnetworks.
6. Klik kotak centang di samping kuota yang ingin Anda batasi, lalu klik EDIT KUOTA.
7. Isi formulir perubahan kuota, termasuk batas baru yang ingin Anda tetapkan.
8. Klik KIRIM PERMINTAAN.

Beberapa API memungkinkan Anda meminta batas yang lebih tinggi dengan mengirimkan formulir. Beberapa API memungkinkan Anda menentukan kuota yang lebih tinggi hanya jika penagihan diaktifkan di project.

Catatan: Anda dapat menetapkan batas yang dapat ditagih harian hanya pada API yang dapat ditagih, dan dalam beberapa kasus, hanya jika penagihan diaktifkan di project Anda. Jika project Anda tidak menggunakan API yang dapat ditagih, batas harian tidak dapat ditetapkan. Pelajari akun penagihan lebih lanjut.

Bagian kuota Premium Plan berkaitan dengan Premium Plan Google Maps, yang tidak lagi ditawarkan. Jangan edit bagian tersebut kecuali jika Anda adalah pelanggan paket Premium Google Maps saat ini.

Membatasi permintaan per pengguna

Untuk mencegah pengguna menghabiskan kuota API Anda, beberapa API menyertakan batas default per pengguna per menit.

Untuk memeriksa apakah API Anda menyertakan batas default per pengguna per menit, cari di kuota API seperti yang dijelaskan dalam petunjuk untuk Melihat dan mengubah batas jumlah permintaan. Jika batas default tersebut ada untuk API tersebut, Anda dapat mengubah nilai tersebut untuk membatasi kuota yang tersedia bagi setiap pengguna dengan mengikuti langkah-langkah dalam petunjuk ini. Jika API Anda tidak menyertakan batas default ini dalam kuotanya, menambahkan atau mengubahnya tidak didukung.

Setiap pengguna diidentifikasi dengan string unik. Jika Anda membuat aplikasi sisi server (tempat kode panggilan dihosting di server yang Anda miliki) yang membuat permintaan atas nama pengguna, permintaan Anda ke API yang penggunaannya Anda batasi harus menyertakan parameter quotaUser. Parameter ini ditentukan dalam dokumentasi Parameter sistem.

Catatan: Meskipun batas per pengguna ditentukan dalam kueri per menit, kami mengizinkan lonjakan penggunaan jangka pendek. Oleh karena itu, Anda harus menetapkan batas berdasarkan tingkat traffic rata-rata yang berkelanjutan. Jika ada yang mencoba menggunakan API melebihi setelan ini, permintaan akan memicu error batas terlampaui.

Untuk mengidentifikasi pengguna, gunakan parameter kueri URL quotaUser=userID. Nilai ini hanya untuk penerapan kuota jangka pendek, sehingga Anda tidak perlu menggunakan ID pengguna yang sebenarnya. Anda dapat memilih string arbitrer apa pun dengan panjang kurang dari 40 karakter yang secara unik mengidentifikasi pengguna.

Parameter quotaUser hanya digunakan untuk membatasi permintaan per pengguna per menit. Jika Anda tidak mengirim parameter quotaUser, semua panggilan akan diatribusikan ke mesin server Anda. Dalam hal ini, panggilan tidak dapat dibatasi oleh pengguna.

Jika API Anda tidak menyertakan batas default per pengguna per menit, nilai quotaUser akan diabaikan.

Penting: Saat mengirim ID pengguna, pastikan Anda mematuhi hukum setempat, termasuk hukum yang berkaitan dengan pengungkapan informasi pribadi apa pun yang Anda kirim dengan setiap permintaan. Praktik terbaiknya adalah menyertakan sesedikit mungkin informasi pribadi.

Melihat dan mengedit semua kuota untuk API dalam project

Anda dapat meninjau, mengedit, dan meminta batas kuota yang lebih tinggi untuk semua API yang dapat ditagih di project tertentu dengan melihat halaman Kuota di bagian IAM & Admin di konsol Google Cloud.

Untuk melihat dan mengedit kuota semua API yang dapat ditagih di project Anda, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Kuota.

   Buka Quotas

2. Dari daftar project, pilih project atau buat project baru. Halaman Kuota untuk project yang dipilih akan ditampilkan, yang mencantumkan satu item baris untuk setiap jenis kuota yang tersedia di setiap layanan.
3. Klik Filter tabel untuk mengkueri kuota Anda berdasarkan properti tertentu.
4. Centang kotak di samping kuota yang ingin Anda edit. Penagihan harus diaktifkan pada project agar beberapa kotak centang dapat diklik.
   Jika Anda lebih memilih untuk mengedit semua kuota untuk satu API, klik nama layanan untuk mengakses halaman Kuota untuk API tersebut.
5. Klik EDIT KUOTA.
6. Di panel Quota changes yang ditampilkan, luaskan tampilan layanan, lalu edit kuota di layanan tersebut sesuai kebutuhan, lalu klik DONE.
7. Ulangi untuk mengedit kuota di setiap layanan yang dipilih.
   • Batas kuota saat ini sudah terisi otomatis di kotak input.
   • Layanan dengan ikon pemberitahuan () saat pengiriman memiliki error input.
   • Anda dapat menambahkan kuota lainnya untuk diedit dengan memilihnya seperti yang dijelaskan sebelumnya.
   • Anda dapat menghapus layanan dari panel Quota changes dengan mengarahkan kursor ke tampilan layanan yang tidak diperluas, lalu mengklik ikon hapus ().
8. Setelah selesai mengedit kuota, klik BERIKUTNYA.
9. Jika permintaan pengeditan kuota Anda memerlukan peninjauan, formulir Detail kontak akan ditampilkan. Lengkapi formulir dengan detail kontak Anda.
10. Klik KIRIM PERMINTAAN.