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.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Límites de velocidad de datos

Queremos que los desarrolladores creen experiencias de usuario atractivas, pero también queremos que el servicio y los dispositivos Nest estén siempre disponibles para el usuario. Los productos que realizan una gran cantidad de solicitudes en un período de tiempo determinado pueden afectar el servicio y la disponibilidad del dispositivo, por lo que aplicamos límites de tarifa. La limitación de velocidad restringe el número de llamadas API para un período de tiempo determinado.

Tipos de límites de velocidad

Hemos implementado dos clases de límites de velocidad. Los primeros límites son por dispositivo o estructura por hora. Estos límites se comparten en todos los productos de Works with Nest y están destinados a evitar el uso excesivo de dispositivos. La segunda clase de límites son por token de acceso . Estos límites están diseñados para evitar la sobreutilización del servicio Nest.

Por dispositivo / límites de estructura

Cada escritura en el modelo de datos requiere que el dispositivo se active y sincronice el estado. Esto puede afectar la vida útil de la batería, por lo que limitamos el número de escrituras en dispositivos y estructuras. También controlamos el estado de la batería de todos los dispositivos. Si caen por debajo de cierto umbral, rechazaremos las solicitudes de escritura hasta que la batería se haya recargado.

Por límites de token de acceso

Cada token de acceso también tiene un límite de velocidad asociado. El establecimiento de conexiones al servicio conlleva algunos gastos generales, por lo que limitamos la cantidad de conexiones que un producto puede hacer en un período de tiempo específico.

Para las llamadas de transmisión REST y REST, cada token de acceso tiene un número limitado de llamadas. Los límites de velocidad de datos se aplican a las llamadas de lectura / escritura a través de REST, y a las llamadas de lectura a través de la transmisión REST. Para evitar errores, le recomendamos que limite las solicitudes a una llamada por minuto, como máximo.

Respuesta de error

Cuando use REST , recibirá un código de respuesta de 429 Demasiadas solicitudes.

Manejo de redireccionamientos 307

Al hacer llamadas REST , su producto necesitará manejar 307 redirecciones. También conocido como reenvío de URL, una respuesta de redireccionamiento temporal 307 proporciona una nueva URL para que el navegador vuelva a enviar una solicitud.

Cuando se produce una redirección 307, deberá volver a realizar la llamada con la nueva información de URL. Cuando haga esto, debe almacenar en caché el host y el número de puerto para usarlos en futuras llamadas con ese token de usuario / acceso. Recuerde, cada llamada cuenta para el límite de tarifa. Considere cómo su usuario está interactuando con su producto. Algunos usuarios presionarán un botón o elegirán una configuración repetidamente, por lo que si realiza una llamada para cada acción del usuario, puede afectar los límites de velocidad muy rápidamente. Si un usuario realiza una serie de cambios en rápida sucesión, solo debe realizar una llamada a la API para el último valor (el más reciente).

Para obtener más información y un ejemplo, consulte Cómo manejar los redireccionamientos .

Después de 307 redirigir

Si está utilizando la información de URL de redireccionamiento y obtiene un redireccionamiento 307 más adelante, debe seguir ese redireccionamiento.

Error de conexión

Si está utilizando la información de la URL en caché y obtiene un error de conexión (debido a que el host está fuera de servicio o el sitio está inactivo), debe volver a la URL base original.

Cambios de límite de tarifa

A medida que aprendemos más sobre los patrones de uso y su impacto en el servicio, es posible que sea necesario modificar los límites de la tarifa. Le recomendamos encarecidamente que cree sus productos para utilizar la cantidad mínima de llamadas necesarias para crear una experiencia de usuario convincente y para lidiar adecuadamente con las infracciones del límite de tarifas.