New Code Samples
New code samples have been added:
- A Go sample was added to REST Streaming
- A Python 3 sample was added to REST Streaming
- A node.js sample was added to API Read Examples
- A node.js sample was added to API Write Examples
Terms of Service Change
Our Terms of Service have been updated for the General Data Protection Regulation (GDPR).
10 tips video series
A supplemental video series for the 10 tips Python sample app and Codelab has been published.
See Get Started for more information.
Permissions tab redesign
The permissions tab on the OAuth Clients page has been redesigned. Permissions are now grouped by function and multiple permissions can be edited at once.
See Edit permissions for more information.
A new endpoint,
has been added to the Nest API. This state works with Nest Cam to enable
Works with Nest integrations to simulate occupancy and deter intruders.
10 tips for your successful integration
Multiple redirect URIs
Multiple redirect URI support has been added to the Developer Console. See Configure Redirect URIs for more information.
Two new Nest Codelabs have been published on Google Developers:
- Works with Nest API Quick Start Guide - covers the entire Works with Nest integration workflow
- Nest Cam and TensorFlow - how to classify Nest Cam images using TensorFlow
See Codelabs for more information.
Documentation and console updates
The Nest Developers documentation has a new look, aligned with other developer programs at Alphabet. With this change, you can more quickly find what you’re looking for, and we can more quickly update the site.
Developer console update
To help market your product internationally, you can now localize your product entries in the Works with Nest Store.
- name (structure)
- smoke_alarm_state (structure)
- where_name (camera)
- where_name (smoke)
Eco Temperatures and API updates
Setting your thermostat to energy-saving temperatures (now called Eco Temperatures) will not set the home to Away. With Eco Temperatures you can save energy while at home.
Nest customer homes will continue to transition manually or automatically between Home and Away, but users won’t see “Auto-Away” anymore at the home level (they will see “Away”) or on the thermostat (they will see “Eco”).
- Eco Temperatures operate at the device level, and help users save energy,
independent of (structure-level) occupancy
- New Eco Temperature data values - eco_temperature (high and low, F and C)
away_temperaturevalues are deprecated (high and low, F and C)
- Change to structure
awaystates: can be "home" or "away" ("auto-away" is deprecated)
- New "eco" value for device
Data value changes in the Thermostats object
- Thermostat label - you can now read the Thermostat label
- where_name - now get access to
where_nameat the device level, instead of having to look up
where_idfrom the structure first
- Fan timer - you can now set fan_timer_duration
Check out these new API features for the Nest Learning Thermostat and Nest Cam, plus multiplex support for REST streaming apps:
Thermostat API improvements
- Add a custom thermostat
(appears in parentheses, after the where name)
- Write the temperature scale (set F/C)
- Read Temperature Lock status, and if true, read min/max locked temperature values
Camera API improvements
- New snapshot feature - capture an image on demand
- Activity zones
- Read the names of all the activity zones
- After a motion event, see the activity zone(s) where the event was triggered
- See if video access is set to public, and if it is, get the public share URL
Consider multiplex if you're using REST streaming to manage more than 50 users in a Cloud-to-Cloud integration. With multiplex, you can read data in near real-time from many user devices with a single HTTPS connection. Plus, we added advice on how to manage multiple multiplex connections:
- When to create a new multiplex connection
- What to do when an access token is invalid or missing
- How and when to reestablish multiplex connections
- Works with Nest Store - easily reorder images and choose the primary image for your store listing's product page
- Updated humidity advice - it's always rounded to the nearest 5%
- Check out the new developer portal, with improved:
- Product management experience - track your product and marketing review communications
- Organization and navigation - we made it easier to find help and advice
- Load your product information and marketing assets to the Works with Nest Store, and go international with marketing copy supporting these languages: American English (we call it English), French, Dutch, British English, Irish English, Belgian Dutch, Belgian French, Canadian French and Canadian English
- Camera API - access and control Nest Cam (or Dropcam) devices from your Works with Nest product
- Camera-ready Home Simulator - develop your Works with Nest product with virtual cameras
- Energy read permission for energy rush hour - find out if a user is subscribed to a Rush Hour Rewards program and see when the peak period events begin and end
- New marketing categories - this change means that your products may move to a new marketing category
- Improved error messages - you get error messages that are more conversational and informative, with detailed help and advice
- Use the Deauthorization API when your users want to remove a Works with Nest connection. Instead of sending them to the Nest app, you can end the session from within your WWN product. We'll revoke the access token and close the session. This call gives you the same functionality that users have when they remove a WWN connection.
- An updated design and marketing policy consolidates our guidelines to support you in creating your marketing plan, brand strategy, user interface and user experience design for your Works with Nest products.
- We're participating in hackathons around the world. So far this year, we've met over 2,500 developers, watched 4,000 Red Bull cans disappear, and handed out 5,000 stickers. In the events we've been to, we've seen some amazing projects.
- Nest Home Simulator creates virtual Nest devices you can use to simulate different home configurations and device states, including sensor conditions and battery levels. The Nest Home Simulator replaces the Nest Developer Chrome Extension, which will be deprecated after June 2015.
- New fields in the data model:
- You'll use
hvac_stateto learn if the home HVAC system is actively heating, cooling or is off.
wheresis a new object that contains
name. When a user selects a name for their Nest device, they choose from a standard list we provide, like "Kitchen", "Hallway" or "Kid's Room". This new
wheresobject allows you to read the list of standard device names from a structure or create (write) a new custom name for a space related to your product. Learn more about Nest Thermostat and Protect names.
- You'll use
- Check out the developer workflow and learn how to build and ship thoughtful Works with Nest products.
- For clients created after this release, the user quota is now 50 users. If you want to release your client to a larger audience, you must submit your client and marketing assets to us for review. After you get our approval, you can launch your product with Works with Nest branding.
Developer portal enhancements
- Track your review status (IN REVIEW, ACCEPTED or DECLINED)
- Client improvements
New data fields available
All fields are read-only.
(when this permission is selected, you can read this field)
|thermostats||/humidity||Humidity, in percent (%) format, measured at the device||Thermostat read
|smoke_co_alarms||is_manual_test_active||State of the manual smoke and CO alarm test||Smoke + CO read|
|smoke_co_alarms||last_manual_test_time||Timestamp of the last successful manual smoke and CO alarm test, in ISO 8601 format||Smoke + CO read|
|structures||postal_code||Postal or zip code, depending on the country||Postal code read|
- Offers the ability to access Home and Away states, smoke and CO alerts, and peak energy rush hour events to build interesting and meaningful integrations while maintaining control of user experiences
- Requires Nest customers to authorize a connection before any data is shared
- Includes all the tools and support developers need to start building across iOS, Android and the web, as well as the ability to leverage the Works with Nest logo in their product marketing
- Uses industry-standard SSL for encryption to ensure communications between Nest and other products are secure