Kuota dan batas Smart Home

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

Batas API HomeGraph

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

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

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

  • Subjek email: Request to increase ReportState API Quota
  • Konten email:
    • Project ID
    • Nama perusahaan Anda
    • Kuota saat ini
    • Alasan Anda ingin meningkatkan kuota
Kuota 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 integrasi Cloud-to-cloud. Ya
Kueri Batas default 6.000 permintaan per 60 detik per integrasi Cloud-to-cloud. Ya
Sinkronisasi Batas default 6.000 permintaan per 60 detik per integrasi Cloud-to-cloud. Ya
Hapus Batas default 6.000 permintaan per 60 detik per integrasi Cloud-to-cloud. Ya
ReportStateAndNotification Batas default 6.000 permintaan per 60 detik per integrasi Cloud-to-cloud. 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 berdampak negatif pada integrasi Anda dengan menyebabkan ketidakcocokan status. Misalnya, jika permintaan ReportStateAndNotification dihapus karena pembatasan kapasitas, status perangkat fisik akan gagal disinkronkan, sehingga Google Home app (GHA) 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.