Kuota dan batas Smart Home

Google Home membatasi alokasi dan penggunaan resource, serta menerapkan kuota yang sesuai berdasarkan per project. Kebijakan tertentu bervariasi bergantung pada ketersediaan resource, profil pengguna, histori penggunaan layanan, serta faktor lainnya, dan dapat berubah tanpa pemberitahuan.

Batas HomeGraph API

Bagian ini mencantumkan batas kapasitas untuk Google Home Graph API. Batas ini berlaku untuk REST dan RPC API.

Google menerapkan batas default 6.000 permintaan per 60 detik ke gabungan panggilan API kueri, sinkronisasi, penghapusan, Report State, dan sinkronisasi permintaan asinkron Anda, berdasarkan per Cloud-to-cloud integrasi.

Untuk meminta penambahan kuota, hubungi ha-certification@google.com dengan informasi berikut:

  • Subjek email: Request to increase ReportState API Quota
  • Isi email:
    • Project ID
    • Nama perusahaan Anda
    • Kuota saat ini
    • Alasan Anda ingin meningkatkan kuota
Quota Batas Bisa ditingkatkan
RequestSync (mode sinkron) Maksimum 1 permintaan serentak per agentUserId. Tidak
RequestSync (mode asinkron) Batas default 6.000 permintaan per 60 detik per Cloud-to-cloud integrasi. Ya
Kueri Batas default 6.000 permintaan per 60 detik per Cloud-to-cloud integrasi. Ya
Sinkronisasi Batas default 6.000 permintaan per 60 detik per Cloud-to-cloud integrasi. Ya
Hapus Batas default 6.000 permintaan per 60 detik per Cloud-to-cloud integrasi. Ya
ReportStateAndNotification Batas default 6.000 permintaan per 60 detik per Cloud-to-cloud integrasi. Ya

Men-debug masalah kuota

Jika integrasi Anda mengalami pembatasan kapasitas, gunakan panduan berikut untuk mendiagnosis dan menyelesaikan masalah kuota:

  1. Google akan membatasi kapasitas panggilan API yang melebihi kuota Anda. Hal ini akan berdampak negatif pada integrasi Anda karena menyebabkan ketidakcocokan status. Misalnya, jika permintaan ReportStateAndNotification dihentikan karena pembatasan kapasitas, status perangkat fisik akan gagal disinkronkan, sehingga Google Home app (GHA) akan memiliki informasi yang sudah tidak berlaku.

  2. Jika RequestSync adalah API utama yang mengalami error, pastikan layanan Anda tidak mencoba melakukan lebih dari satu panggilan serentak per agentUserId.

  3. Tinjau pertumbuhan traffic Anda dari waktu ke waktu. Jika pertumbuhan ini konsisten dengan peningkatan jumlah perangkat, peluncuran jenis perangkat baru, atau peluncuran lain yang diharapkan, minta penambahan kuota. Jika peningkatan ini tidak terduga, tinjau integrasi Anda untuk menentukan apakah perubahan yang tidak terduga menyebabkan lebih banyak traffic dikirim ke Home Graph API.