Sistem kuota telah diterapkan untuk Home API guna memastikan keandalan layanan dan membantu developer mengelola volume traffic secara efektif. Kuota di Home API berada di Google Cloud level project.
Batas kapasitas untuk Home API adalah 30.000 QPM (kueri per menit) per project. Batas ini mencakup semua kueri yang dikirim melalui Home API.
Kuota melampaui batas
Jika batas kecepatan API Home terlampaui, pengecualian
resourceExhaused
HomeException
akan ditampilkan. Permintaan berikutnya akan langsung ditolak
dengan pesan "Kuota terlampaui".
Jika kuota terlampaui, aplikasi harus menampilkan penundaan eksponensial dan memberi tahu pengguna jika tindakan dibatasi untuk sementara.
Pemantauan
Gunakan Konsol Google Cloud untuk memantau penggunaan secara real-time dan mengonfigurasi pemberitahuan proaktif saat Anda hampir mencapai kuota Home API.
Untuk melihat metrik saat ini, buka bagian Metrik dari layanan Home API di project Google Cloud yang terkait dengan pendaftaran aplikasi Anda di Google Home Developer Console.
Menyiapkan pemberitahuan
Sebaiknya partner menyiapkan pemberitahuan untuk melewati batas (seperti 80%) kuota yang dialokasikan. Dukungan pemberitahuan di Google Cloud sangat luas dan dapat dikonfigurasi.
Saat membuat pemberitahuan untuk kuota, Anda sebaiknya menggunakan metrik berikut di bagian Consumer Quota > Quota di pembuat kebijakan.
- Penggunaan kuota alokasi — serviceruntime.googleapis.com/quota/allocation/usage
- Batas kuota — serviceruntime.googleapis.com/quota/limit
Partner juga harus menyiapkan saluran notifikasi (seperti email) untuk menerima pemberitahuan kuota.
Lihat referensi berikut untuk mempelajari lebih lanjut pemberitahuan dan notifikasi, serta cara mengonfigurasinya di Google Cloud:
Meminta penambahan kuota
Jika aplikasi Anda memiliki traffic yang sah yang memerlukan batas yang lebih tinggi daripada batas frekuensi default, Anda dapat meminta peningkatan.
Untuk melihat penggunaan dan batas, buka bagian Kuota & Batas Sistem dari layanan Home API di project Google Cloud yang terkait dengan pendaftaran aplikasi Anda di Developer Console.
Untuk meminta penambahan, edit kuota tertentu. Lihat Meminta penyesuaian kuota dalam dokumentasi Google Cloud untuk mengetahui petunjuknya.