Release Notes

May 2018

New Code Samples

New code samples have been added:

Terms of Service Change

Our Terms of Service have been updated for the General Data Protection Regulation (GDPR).

March 2018

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.

January 2018

Security API

A new endpoint, wwn_security_state, 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.

See Security for more information on the API and Product Review Guidelines for related updates.

October 2017

10 tips for your successful integration

A new sample app and companion Codelab have been published. The sample app is based on Python and also uses JavaScript and Jinja templates to demonstrate how to build a Works with Nest integration that follows best practices and adheres to the Product Review Guidelines.

See Samples and Codelabs for more information.

July 2017

Multiple redirect URIs

Multiple redirect URI support has been added to the Developer Console. See Configure Redirect URIs for more information.

June 2017

Permission updates

May 2017

New codelabs

Two new Nest Codelabs have been published on Google Developers:

See Codelabs for more information.

April 2017

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.

March 2017

Developer console update

The OAuth Clients page has been updated with a new tabbed layout for easier navigation when editing products. See Register a Product for more information.

February 2017

Localization

To help market your product internationally, you can now localize your product entries in the Works with Nest Store.

See Works with Nest store.

November 2016

Permissions updates

API updates

October 2016

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)
    • All away_temperature values are deprecated (high and low, F and C)
  • Change to structure away states: can be "home" or "away" ("auto-away" is deprecated)
  • New "eco" value for device hvac_mode

Data value changes in the Thermostats object

May 2016

Check out these new API features for the Nest Learning Thermostat and Nest Cam, plus multiplex support for REST streaming apps:

Where name (label)
Where name (label)

Thermostat API improvements

Camera API improvements

Multiplex

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

Other improvements

  • 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%

October 2015

  • 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

July 2015

  • 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.

May 2015

  • 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:
    • hvac_state and wheres
      • You'll use hvac_state to learn if the home HVAC system is actively heating, cooling or is off.
      • wheres is a new object that contains where_id and 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 wheres object 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.
  • 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.

November 2014

Developer portal enhancements

  • Track your review status (IN REVIEW, ACCEPTED or DECLINED)
  • Client improvements
    • Edit client - edit most fields (client name, description, product info, URLs, and permission descriptions)
    • Delete client - permanently delete a client
    • Add or edit permissions - if you add or edit permissions after a client is created, then your users will be notified that the client was updated

Learn more about changing permissions after a client is created

New data fields available

All fields are read-only.

Object Field Description Permission
(when this permission is selected, you can read this field)
thermostats /humidity Humidity, in percent (%) format, measured at the device Thermostat read
Thermostat read/write
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

June 2014

  • 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