Membatasi penggunaan API

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

Batas ini adalah batas penggunaan khusus API. Misalnya, untuk menghindari biaya karena melebihi penggunaan gratis, Anda dapat menetapkan batas permintaan per hari.

Batas ini ditujukan untuk kontrol terperinci atas volume layanan tertentu dan tidak dirancang untuk bertindak sebagai batas pembelanjaan di seluruh project. Jika Anda ingin mencegah biaya tak terduga untuk seluruh project atau akun penagihan, lihat Membuat, mengedit, atau menghapus anggaran dan pemberitahuan anggaran.

Penting: Batas kuota tidak selalu sepenuhnya akurat, karena ada latensi antara saat kuota terlampaui dan saat penegakan dimulai. Saat menggunakan kuota sebagai alat untuk membatasi penagihan, berikan sedikit buffer.

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 rendah hingga Anda mengaktifkan penagihan di project.

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

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

   Buka Dashboard APIs &Services

2. Dari daftar project, pilih project atau buat project baru.
3. Klik nama API yang Anda minati.
4. Klik Quotas. Jika tab Quotas tidak ada di navigasi tab, berarti 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 field. Misalnya, untuk menemukan kuota Subnetworks, masukkan Quota:Subnetworks.
6. Centang kotak di samping kuota yang ingin Anda batasi, lalu klik EDIT QUOTAS.
7. Isi formulir perubahan kuota, termasuk batas baru yang ingin Anda tetapkan.
8. Klik SUBMIT REQUEST.

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 secara 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 Google Maps Premium Plan, yang tidak lagi ditawarkan. Kecuali jika Anda adalah pelanggan Google Maps Premium Plan saat ini, jangan edit bagian tersebut.

Membatasi permintaan per pengguna

Untuk mencegah pengguna individual menggunakan 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 Anda 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, penambahan atau pengubahannya tidak didukung.

Setiap pengguna diidentifikasi oleh 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 yang melebihi setelan ini, permintaan akan memicu error limit exceeded.

Untuk mengidentifikasi pengguna, gunakan parameter kueri URL quotaUser=userID. Nilai ini hanya untuk penegakan kuota jangka pendek, jadi Anda tidak perlu menggunakan ID pengguna yang sebenarnya. Anda dapat memilih string arbitrer apa pun yang panjangnya 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 dikaitkan dengan mesin server Anda, sehingga panggilan tidak dapat dibatasi per 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 yang berkaitan dengan pengungkapan informasi pribadi yang Anda kirim dengan setiap permintaan. Praktik terbaiknya adalah menyertakan informasi pribadi sesedikit mungkin.

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 dalam project tertentu dengan melihat halaman Quotas di bagian IAM & Admin di Google Cloud konsol.

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

1. Di Google Cloud konsol, buka halaman Quotas.

   Buka Kuota

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 table 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 suka mengedit semua kuota untuk satu API, klik nama layanan untuk mengakses halaman Quotas untuk API tersebut.
5. Klik EDIT QUOTAS.
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 otomatis di kotak input.
   • Layanan dengan ikon peringatan () saat pengiriman memiliki error input.
   • Anda dapat menambahkan lebih banyak kuota 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 NEXT.
9. Jika permintaan pengeditan kuota Anda memerlukan peninjauan, formulir Contact details akan ditampilkan. Isi formulir dengan detail kontak Anda.
10. Klik SUBMIT REQUEST.