Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Limites de taxa de dados

Queremos que os desenvolvedores criem experiências atraentes para o usuário, mas também queremos que o serviço e os dispositivos Nest estejam sempre disponíveis para o usuário. Os produtos que fazem um grande número de solicitações em um determinado período de tempo podem afetar a disponibilidade de serviços e dispositivos, por isso aplicamos limites de taxa. A limitação de taxa restringe o número de chamadas da API por um determinado período.

Tipos de limites de taxa

Implementamos duas classes de limites de taxa. Os primeiros limites são por dispositivo ou estrutura por hora. Esses limites são compartilhados entre todos os produtos Works with Nest e visam impedir a superutilização de dispositivos. A segunda classe de limites é por token de acesso . Esses limites foram criados para impedir a superutilização do serviço Nest.

Limites por dispositivo / estrutura

Toda gravação no modelo de dados exige que o dispositivo ative e sincronize o estado. Isso pode afetar a vida útil da bateria, portanto limitamos o número de gravações em dispositivos e estruturas. Também monitoramos o estado da bateria de todos os dispositivos. Se eles ficarem abaixo de um certo limite, rejeitaremos as solicitações de gravação até que a bateria seja recarregada.

Limites de token por acesso

Cada token de acesso também possui um limite de taxa associado. Estabelecer conexões com o serviço incorre em alguma sobrecarga; portanto, limitamos o número de conexões que um produto pode fazer em um período específico.

Para chamadas de streaming REST e REST, cada token de acesso possui um número limitado de chamadas. Os limites da taxa de dados se aplicam a chamadas de leitura / gravação via REST e a chamadas de leitura via streaming REST. Para evitar erros, recomendamos que você limite as solicitações a uma chamada por minuto, no máximo.

Resposta de erro

Ao usar o REST, você receberá um código de resposta 429 Demasiadas solicitações.

Manipulando 307 redirecionamentos

Ao fazer chamadas REST , seu produto precisará lidar com 307 redirecionamentos. Também conhecido como encaminhamento de URL, uma resposta de redirecionamento temporário 307 fornece um novo URL para o navegador reenviar uma solicitação.

Quando um redirecionamento 307 acontece, você precisará fazer a chamada novamente com as novas informações de URL. Ao fazer isso, você deve armazenar em cache o número do host e da porta para uso em chamadas futuras com esse token de usuário / acesso. Lembre-se de que cada chamada conta para o limite da tarifa. Considere como seu usuário está interagindo com seu produto. Alguns usuários pressionam um botão ou escolhem uma configuração repetidamente; portanto, se você fizer uma chamada para cada ação do usuário, isso poderá afetar os limites da taxa muito rapidamente. Se um usuário fizer uma série de alterações em rápida sucessão, faça uma chamada de API apenas para o último valor (mais recente).

Para mais informações e um exemplo, consulte Como lidar com redirecionamentos .

Após o redirecionamento 307

Se você estiver usando as informações da URL de redirecionamento e obtiver um redirecionamento 307 posteriormente, siga esse redirecionamento.

Erro de conexão

Se você estiver usando as informações da URL em cache e receber um erro de conexão (devido ao host de serviço ou site inoperante), você deve reverter para a URL base original.

Alterações no limite de taxa

À medida que aprendemos mais sobre os padrões de uso e seu impacto no serviço, podemos achar necessário modificar os limites de taxa. Recomendamos enfaticamente que você crie seus produtos para usar o número mínimo de chamadas necessárias para criar uma experiência atraente para o usuário e para lidar com as violações dos limites de taxa de maneira apropriada.