jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-23 17:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update First time setup (#10605)

Browse Source
This commit is contained in:
markharleman 2019-10-15 13:43:35 +02:00 committed by Franck Nijhof
parent 56149ae389
commit 46af2e2676
1 changed files with 13 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
source/_integrations/google_assistant.markdown
View File

@ -64,27 +64,26 @@ You need to create an API Key with the [Google Cloud API Console](https://consol
1. Create a new project in the [Actions on Google console](https://console.actions.google.com/).
1. Add/Import a project and give it a name.
2. Click on the `Home Control` card, select the `Smart home` recommendation.
3. Click `Build your Action`, select `Add Action(s)`, and click `Add your first action`. Add your Home Assistant URL: `https://[YOUR HOME ASSISTANT URL:PORT]/api/google_assistant`, replace the `[YOUR HOME ASSISTANT URL:PORT]` with the domain / IP address and the port under which your Home Assistant is reachable.
4. Click `Done`. Then click on `Overview`, which will lead you back to the app details screen.
2. Click on the `Smart Home` card, select the `Smart home` recommendation.
3. Click `Build your Action`, select `Add Action(s)`. Add your Home Assistant URL: `https://[YOUR HOME ASSISTANT URL:PORT]/api/google_assistant` in the `Fulfillment URL` box, replace the `[YOUR HOME ASSISTANT URL:PORT]` with the domain / IP address and the port under which your Home Assistant is reachable.
4. Click `Save`. Then click on `Overview`, which will lead you back to the app details screen.
2. `Account linking` is required for your app to interact with Home Assistant. Set this up under the `Quick Setup` section.
1. Leave it at the default `No, I only want to allow account creation on my website` and select Next.
2. For the `Linking type` select `OAuth` and `Authorization Code`.
1. Leave it at the default `No, I only want to allow account creation on my website` and select `Next`.
2. For the `Linking type` select `OAuth` and `Authorization Code`. Click `Next`
3. Client ID: `https://oauth-redirect.googleusercontent.com/`, the trailing slash is important.
4. Client Secret: Anything you like, Home Assistant doesn't need this field.
5. Authorization URL (replace with your actual URL): `https://[YOUR HOME ASSISTANT URL:PORT]/auth/authorize`.
6. Token URL (replace with your actual URL): `https://[YOUR HOME ASSISTANT URL:PORT]/auth/token`.
6. Token URL (replace with your actual URL): `https://[YOUR HOME ASSISTANT URL:PORT]/auth/token`. Click `Next`
7. Configure your client: Type `email` and click `Add scope`, then type `name` and click `Add scope` again.
8. Do **NOT** check `Google to transmit clientID and secret via HTTP basic auth header`.
9. Testing instructions: Enter anything. It doesn't matter since you won't submit this app.
8. Do **NOT** check `Google to transmit clientID and secret via HTTP basic auth header`. Click `Next`
9. Testing instructions: Enter anything. It doesn't matter since you won't submit this app. Click `Save`
<img src='/images/integrations/google_assistant/accountlinking.png' alt='Screenshot: Account linking'>
3. Under `Build your Action` click `Add Action(s)`.
1. Under `Fulfillment` fill in this URL (replace with your actual URL): `https://[YOUR HOME ASSISTANT URL:PORT]/api/google_assistant`.
4. Select the `Develop` tab at the top of the page, then in the upper right hand corner select the `Test` button to generate the draft version Test App.
5. Add the `google_assistant` integration configuration to your `configuration.yaml` file and restart Home Assistant following the [configuration guide](#configuration) below.
6. Open the Google Home app and go into `Account > Settings > Assistant > Home Control`.
7. Click the `+` sign, and near the bottom, you should have `[test] your app name` listed under 'Add new.' Selecting that should lead you to a browser to login your Home Assistant instance, then redirect back to a screen where you can set rooms for your devices or nicknames for your devices.
3. Select the `Develop` tab at the top of the page, then in the upper right hand corner select the `Test` button to generate the draft version Test App.
4. Add the `google_assistant` integration configuration to your `configuration.yaml` file and restart Home Assistant following the [configuration guide](#configuration) below.
5. Open the Google Home app and goto `Account` most right icon.
6. Click `+ Set up or add`, `+ Set up device`, 'New devices', choose your home and click `Next` click `Have something...`you should have `[test] your app name` listed under 'Add new.' Selecting that should lead you to a browser to login your Home Assistant instance, then redirect back to a screen where you can set rooms for your devices or nicknames for your devices.
<div class='note'>