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-17 14:26:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Nest SDM: subscription_id should be subscriber_id (#15393)

Browse Source
This commit is contained in:
Matthew Donoughe 2020-10-25 16:32:56 -04:00 committed by Franck Nijhof
parent 7400b5753a
commit e15a98146d
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
source/_integrations/nest.markdown
View File

@ -41,13 +41,13 @@ Quick Start Guide:
- Register in the Device Access Console to get a `project_id`. - Register in the Device Access Console to get a `project_id`.
- Authorize your Google Account and create OAuth credentials to get a `client_id` and `client_secret`. - Authorize your Google Account and create OAuth credentials to get a `client_id` and `client_secret`.
- Enable pubsub events in the Device Access Console (creates a topic). - Enable pubsub events in the Device Access Console (creates a topic).
- Create a pull subscription to get a `subscription_id`. - Create a pull subscription to get a `subscriber_id` ("Subscription ID" in Google Cloud Console).
Additionally, Home Assistant must be configured with a URL (e.g., external exposed [`http`](/integrations/http/), Nabu Casa, etc). When setting up the OAuth credentials, make sure the Home Assistant URL is in the list of *Authorized redirect URIs*, so the redirect back to Home Assistant can get an OAuth authorization code. Additionally, Home Assistant must be configured with a URL (e.g., external exposed [`http`](/integrations/http/), Nabu Casa, etc). When setting up the OAuth credentials, make sure the Home Assistant URL is in the list of *Authorized redirect URIs*, so the redirect back to Home Assistant can get an OAuth authorization code.
Follow all of the instructions in [Device Access: Quick Start Guide](https://developers.google.com/nest/device-access/get-started) carefully as it is easy to make a configuration mistake that is difficult to debug. It is recommended to exercise the entire guide, including the command to test out the API, to make sure that it is working before configuring Home Assistant. Follow all of the instructions in [Device Access: Quick Start Guide](https://developers.google.com/nest/device-access/get-started) carefully as it is easy to make a configuration mistake that is difficult to debug. It is recommended to exercise the entire guide, including the command to test out the API, to make sure that it is working before configuring Home Assistant.
It may be easiest to create a [Pub/Sub subscription](https://console.cloud.google.com/cloudpubsub/subscription/list) from the Google Cloud console. Make sure to use the *topic name* from the device access console and a unique subscription name. Note the message retention is how long messages will queue while offline, so keep that short (e.g., under an hour) to avoid a potentially large backlog of updates. It may be easiest to create a [Pub/Sub subscription](https://console.cloud.google.com/cloudpubsub/subscription/list) from the Google Cloud console. Make sure to use the *topic name* from the device access console and a unique subscription ID. Note the message retention is how long messages will queue while offline, so keep that short (e.g., under an hour) to avoid a potentially large backlog of updates.
## Works With Nest: Developer Account Setup (Legacy) ## Works With Nest: Developer Account Setup (Legacy)
@ -83,7 +83,7 @@ nest:
client_secret: CLIENT_SECRET client_secret: CLIENT_SECRET
# Fields required by Device Access (SDM) API. Otherwise, use legacy API. # Fields required by Device Access (SDM) API. Otherwise, use legacy API.
project_id: PROJECT_ID project_id: PROJECT_ID
subscriber_id: SUBSCRIBER_ID subscriber_id: SUBSCRIBER_ID # ("Subscription ID" in Google Cloud Console)
``` ```
```yaml ```yaml
@ -106,11 +106,11 @@ client_secret:
required: true required: true
type: string type: string
project_id: project_id:
description: Your Device Access project_id. This enables the SDM API. description: Your Device Access Project ID. This enables the SDM API.
required: false required: false
type: string type: string
subscription_id: subscriber_id:
description: Your Pub/sub subscription_id used to receive events. This is required to use the SDM API. description: Your Pub/sub Subscription ID used to receive events. This is required to use the SDM API.
type: string type: string
required: false required: false
structure: structure: