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 tingkat 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 kapasitas Home API terlampaui, a
resourceExhaused
HomeError akan ditampilkan. Permintaan berikutnya akan langsung ditolak dengan pesan "Kuota melampaui batas".
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 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 nilai minimum (seperti 80%) kuota yang dialokasikan. Dukungan pemberitahuan di Google Cloud sangat luas dan sangat dapat dikonfigurasi.
Saat membuat pemberitahuan untuk kuota, Anda harus menggunakan metrik berikut di bagian Kuota Konsumen > Kuota 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, dan cara mengonfigurasinya di Google Cloud:
Meminta penambahan kuota
Jika aplikasi Anda memiliki traffic yang sah dan memerlukan batas yang lebih tinggi daripada batas kapasitas default, Anda dapat meminta penambahan.
Untuk melihat penggunaan dan batas, buka bagian Kuota & Batas Sistem 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 di dokumentasi Google Cloud untuk mengetahui petunjuknya.