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 level project Google Cloud.
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 kapasitas API Home terlampaui, resourceExhaused
HomeException
akan ditampilkan. Permintaan berikutnya akan segera ditolak dengan pesan "Kuota terlampaui".
Jika kuota terlampaui, aplikasi harus menampilkan backoff eksponensial dan memberi tahu pengguna jika tindakan dibatasi untuk sementara.
Pemantauan
Gunakan Google Cloud Console untuk memantau penggunaan secara real-time dan mengonfigurasi pemberitahuan proaktif saat Anda mendekati kuota Home API.
Untuk melihat metrik saat ini, buka bagian Metrik di layanan Home API dalam 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%) dari kuota alokasi Anda. Dukungan pemberitahuan di Google Cloud sangat luas dan sangat dapat dikonfigurasi.
Saat membuat pemberitahuan untuk kuota, Anda dapat 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 sah yang memerlukan batas lebih tinggi daripada batas kapasitas 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.