Membatasi penggunaan API

Bergantung pada API, Anda dapat secara eksplisit membatasi permintaan 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, agar Anda tidak ditagih atas penggunaan di luar batas penggunaan gratis, Anda dapat menetapkan batas permintaan per hari.

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

Melihat dan mengubah batas jumlah permintaan

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

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

1. Di konsol Google Cloud, buka halaman APIs & Services Dashboard.

   Buka Dasbor APIs & Services

2. Dari daftar project, pilih project atau buat project baru.
3. Klik nama API yang Anda minati.
4. Klik Kuota. Jika tab Quotas tidak ada di navigasi tab, artinya API yang Anda pilih tidak memiliki kuota yang ditentukan.
5. Untuk menemukan kuota yang ingin dibatasi, 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 dibatasi, 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 pada 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 Paket Premium berkaitan dengan Premium Plan Google Maps, yang tidak lagi ditawarkan. Jangan edit bagian tersebut, kecuali jika Anda adalah pelanggan paket Google Maps Premium.

Membatasi permintaan per pengguna

Untuk mencegah pengguna individual 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 batasan tersebut dalam kuota API seperti yang dijelaskan dalam petunjuk untuk Melihat dan mengubah batas jumlah permintaan. Jika ada batas default untuk API tersebut, Anda dapat mengubah nilai tersebut untuk membatasi kuota yang tersedia bagi setiap pengguna dengan mengikuti langkah-langkah dalam petunjuk berikut. Jika API Anda tidak menyertakan batas default ini dalam kuotanya, penambahan atau modifikasinya tidak akan didukung.

Pengguna individual diidentifikasi dengan string yang unik. Jika Anda membuat aplikasi sisi server (dengan kode panggilan yang dihosting di server yang Anda miliki) yang membuat permintaan atas nama pengguna, permintaan Anda ke API yang Anda batasi penggunaannya 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 berkelanjutan. Jika ada orang yang mencoba menggunakan API yang 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, jadi Anda tidak perlu menggunakan ID pengguna sebenarnya. Anda dapat memilih string arbitrer dengan panjang kurang dari 40 karakter yang mengidentifikasi pengguna secara unik.

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 apa pun, pastikan Anda mematuhi hukum setempat, termasuk hukum apa pun yang berkaitan dengan pengungkapan informasi pribadi apa pun yang Anda kirim bersama setiap permintaan. Praktik terbaiknya adalah menyertakan informasi pribadi sesedikit mungkin.

Melihat dan mengedit semua kuota untuk API dalam sebuah project

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

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

1. Di Google Cloud Console, buka halaman Quotas.

   Buka Quotas

2. Dari daftar project, pilih project atau buat project baru. Halaman Quotas 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 dapat mengklik beberapa kotak centang.
   Jika Anda ingin mengedit semua kuota untuk satu API, klik nama layanan guna mengakses halaman Quotas 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 telah diisi sebelumnya dalam 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 belum diluaskan, lalu mengklik ikon hapus ().
8. Setelah selesai mengedit kuota, klik BERIKUTNYA.
9. Jika permintaan edit kuota Anda perlu ditinjau, formulir Detail kontak akan ditampilkan. Lengkapi formulir dengan detail kontak Anda.
10. Klik KIRIM PERMINTAAN.