Device Access projeler kullanıcı, yapı ve hız sınırlarıyla kısıtlanmıştır Bu teklif, ortama ve ticari teklifin türüne göre değişiyor.
Geliştiricilerin ilgi çekici kullanıcı deneyimleri oluşturmalarını istiyoruz ancak Nest hizmeti ve cihazları her zaman kullanılabilir olmalıdır. Entegrasyon işlemleri kısa sürede çok sayıda istek göndermek, hizmeti ve cihaz kullanılabilirliği nedeniyle SDM API'nin hız sınırlamalarını uygulaması gerekir. Hız sınırlaması, belirli bir dönemdeki API çağrılarının sayısını kısıtlar ve kaynakların aşırı kullanılmasını önler.
Ortama göre sınırlar
Tüm projeler Korumalı Alan ortamında başlar. Korumalı Alan SDM API'nin ve kişisel kullanımın değerlendirilmesi amacıyla hazırlanmış ve gerektiği şekilde sınırlandırılmıştır. Daha geniş kullanıcı tabanlarına sahip ortamlar; ör. Ticari Geliştirme için farklı sınırlar geçerlidir.
Korumalı alan kullanıcı sınırları
Korumalı Alan'daki geliştirici hesabı her 5'te 25 kullanıcıyla sınırlıdır tüm projelerdeki yapılardan oluşur. Hesap başına 3 proje sınırı vardır.
Yapıların her biri 5 kullanıcı ile sınırlıdır, bu nedenle kullanıcı sınırına yalnızca ulaşılır kullanıcı sayısı da 5 kullanıcı olacak şekilde maksimize edilen 5 yapıyı tamamlayın. Geliştirici hesabı (projenin sahibi olan kullanıcı) bir kullanıcının 5 kullanıcı sınırına dahil edilmez. inceleyeceğiz.
Öte yandan, bir projede 5 yapıdan 15 kullanıcı varsa ilave kullanıcılar da Yapı sınırı nedeniyle yalnızca mevcut 5 yapıya eklenmelidir. zaten ulaşıldı.
Korumalı alan hız sınırları
Korumalı alan 3 farklı düzeyde hız sınırlamasına tabidir. Sınırlar şu şekilde ayarlandı: sorgu sayısı (QPM) belirleyin.
API seviyesi
API çağrıları proje ve kullanıcı başına sınırlıdır. Bkz. API Bireysel başvurularla ilgili daha fazla bilgi için, yöntemlerine göz atın.
| API Yöntemi | Hız Sınırı |
|---|---|
devices.executeCommand |
10 QPM |
devices.get |
10 QPM |
devices.list |
5 QPM |
structures.get |
5 QPM |
structures.list |
5 QPM |
structures.rooms.get |
5 QPM |
structures.rooms.list |
5 QPM |
Komut düzeyi
Her özellik komutu (devices.executeCommand) proje başına 5 QPM ile sınırlıdır.
(ör. kullanıcı başına)
Yani bir projede her birinde 2 cihaz bulunan 2 kullanıcı (toplamda 4 cihaz) varsa aynı komut bu 4 cihazın her biri için dakikada 5 kez çağrılabilir.
Ancak bir projede 2 kullanıcı ve her birinde toplam 6 cihaz varsa
aynı komut bu 6 komutun her biri için dakikada 5 kez çağrılanamadı
cihazlar. Bu da her kullanıcı için 15 QPM ile sonuçlanacaktır:
devices.executeCommand Bir projenin kullanıcıları için API düzeyi hız sınırı 10 QPM'dir.
Cihaz örneği düzeyi
Ek olarak, cihaz örneği düzeyinde sınırlar projeler genelinde uygulanır ve
komutlarına (devices.executeCommand) gidin. Bu sınırlar
hem QPM hem de saat başına sorgu (QPH) düzeylerinde uygulanır ve
get ve list API yöntemlerine.
Örneğin, A projesi ile B projesinin aynı cihaz A cihazı (kullanıcının iki farklı ticari marka için entegrasyon) ekleyebilirsiniz. Proje A projesi A cihazı bir dakika içinde A cihazı, sonra B Projesi A cihazına yalnızca 1 komut gönderebilir cihaz örnek düzeyindeki hız sınırına ulaşmadan aynı dakika önce. O zaman olduğundan, her iki Projeden A cihazına giden komutlar A cihazına ilk komutla başlayan dakika.
Bir cihaz türü aşağıda listelenmiyorsa cihaz örneği düzeyi yok demektir sıklık sınırı var.
| Cihazın Türü | Cihaz Örnek Hız Sınırı |
|---|---|
| TERARAT | 5 QPM veya 100 QPH |
| KAMERA | 30 QPM veya 100 QPH |
| DOORBELL | 30 QPM veya 100 QPH |
Hatalar
Bu kılavuzla ilgili olarak aşağıdaki hata kodları döndürülebilir:
| Hata Mesajı | TBG | Sorun giderme |
|---|---|---|
| Hız sınırlandırıldı. | RESOURCE_EXHAUSTED |
Her geliştiricinin, yapabileceği çağrı sayısını sınırlandıran bir kotası vardır. Kotanızdan daha fazla çağrı yaparsanız Hız sınırlamalı mesajını alırsınız. Bu sorunu düzeltmek için kotanın süresi dolduğunda çağrıyı yeniden gönderin. |
Aşağıdakiler için API Hata Kodu Referansı'na bakın: API hata kodlarının tam listesini inceleyin.