From 4a7bcaad5cdf1b69e7ff8b7ef9bd73a049e794e7 Mon Sep 17 00:00:00 2001 From: Brent Hughes Date: Sat, 3 Dec 2016 15:13:01 -0600 Subject: [PATCH] Updated Nest Documentation for Oauth2 (#1532) * Updated Nest Documentation for Oauth2 * Update nest.markdown --- source/_components/nest.markdown | 28 ++++++++++++++++++++++++---- 1 file changed, 24 insertions(+), 4 deletions(-) diff --git a/source/_components/nest.markdown b/source/_components/nest.markdown index 4ca7c7dc706..5327e21b96e 100644 --- a/source/_components/nest.markdown +++ b/source/_components/nest.markdown @@ -14,18 +14,38 @@ featured: true The Nest component is the main component to integrate all [Nest](https://nest.com/) related platforms. To connect Nest, you will have to [sign up for a developer account](https://developers.nest.com/products) and get a client_id and client_secret. +### {% linkable_title Setting up developer account %} + +1. Log into [https://developers.nest.com/](https://developers.nest.com/) +2. Fill in account details + - The compnay details can be any made up information. +3. Submit changes +4. Click "[Products](https://developers.nest.com/products)" at top of page +5. Click "[Create New Product](https://developers.nest.com/products/new)" to start a new api client +6. Fill in details + - Product name must be unique. I recommend [email] - Home Assistant. + - The description, users, urls can all be anything you want +7. For permissions check every box and if it's an option select the read/write option. + - The description requires a specific format to be accepted. + - Use "[Home Assistant] [Edit] [For Home Automation]" as the description as it is not super important. +8. Click "Create Product" +9. Once the new product page opens the "Product ID" and "Product Secret" are located on the right side. +10. After these configs are updated and Home Assistant is started a configurator will pop up asking you to log in and copy a authorization code into Home Assistant. + +### {% linkable_title Configuration %} + ```yaml # Example configuration.yaml entry nest: - client_id: ABCD - client_secret: ABCD + client_id: CLIENT_ID + client_secret: CLIENT_SECRET ``` ```yaml # Example configuration.yaml entry to show only devices at your vacation and primary homes nest: - username: USERNAME - password: PASSWORD + client_id: CLIENT_ID + client_secret: CLIENT_SECRET structure: - Vacation - Primary