Library for the Google Nest SDM API
Project description
python-google-nest-sdm
This is a library for Google Nest Device Access using the Smart Device Management API.
Usage
This can be used with the sandbox which requires Registration, accepting terms and a fee.
You'll want to following the Get Started guides for setup including steps in the google cloud console. Overall, this is fairly complicated with many steps that are easy to get wrong. It is likely worth it to make sure you can get the API working using their supplied curl commands with your account before attempting to use this library.
Structure
This API was designed for use in Home Assistant following the advice in Building a Python Library for an API.
If you are integrating this from outside Home Assistant, you'll need to create your own oauth integration and token refresh mechanism and tooling.
Fetching Data
This is an example to use the command line tool to access the API:
PROJECT_ID="some-project-id"
CLIENT_ID="some-client-id"
CLIENT_SECRET="some-client-secret"
# Initial call will ask you to authorize OAuth2 then cache the token
google_nest --project_id="${PROJECT_ID}" --client_id="${CLIENT_ID}" --client_secret="${CLIENT_SECRET}" list_structures
# Subsequent calls only need the project id
google_nest --project_id="${PROJECT_ID}" get_device "some-device-id"
google_nest --project_id="${PROJECT_ID}" set_mode COOL
google_nest --project_id="${PROJECT_ID}" set_cool 25.0
Subscriptions
See Device Access: Getting Started: Subscribe to Events for documentation on how to create a pull subscription.
You can create the subscription to use with the tool with these steps:
- Create the topic:
- Visit the Device Access Console
- Select a project
- Enable Pub/Sub and note the full
topic
based on theproject_id
- Create the subscriber:
- Visit Google Cloud Platform: Pub/Sub: Subscriptions
- Create a subscriber
- Enter the
Topic Name
- Create a
Subscription Name
, e.g. "project-id-python" which is yoursubscriber_id
This is an example to run the command line tool to subscribe:
PROJECT_ID="some-project-id"
SUBSCRIPTION_ID="projects/some-id/subscriptions/enterprise-some-project-id-python-google-nest"
google_nest --project_id="${PROJECT_ID}" subscribe ${SUBSCRIPTION_ID}
Development
$ python3 -m venv venv
$ source venv/bin/activate
$ pip3 install -e .
$ pip3 install -r requirements.txt
# Running tests
$ pytest
# Running tests w/ Code Coverage
$ pytest --cov=google_nest_sdm tests/ --cov-report=term-missing
# Formatting and linting
$ pre-commit run --all-files
Funding and Support
If you are interested in donating money to this effort, instead send a donation to Black Girls Code which is a great organization growing the next generation of software engineers.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for google_nest_sdm-4.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 208a09c44ff993974d1436d023541425efa340c9decda690ab0a0f4acf6efef5 |
|
MD5 | 5a56194b25ab3510a5d52281e6906232 |
|
BLAKE2b-256 | b2b70a25c4fc79f777e7461fdf036a232abe5a55819e72f976194b91c2b1c6c8 |