ioBroker.google-home-nest

Versions

Description

Integrates your Google Home (Nest) devices like Cameras, Doorbells, Displays, Thermostats etc., into the ioBroker system. Please be aware that this adapter is currently in development and in beta status. See section "Current development status, limitations & future goals" for more information.

[!IMPORTANT] In order to use this adapter, you must be registered for Google 'Device Access'. Registration for Google 'Device Access' requires acceptance of the terms of use for the 'Google API' and the 'Device Access Sandbox', as well as a one-time fee of $5 (US dollars) (as of May 2024).

[!IMPORTANT] To receive events from your devices, this adapter creates a 'Pub/Sub subscription' on the Google platform. 'Pub/Sub subscriptions' on the Google platform can specify a message retention duration. This adapter sets this duration to 600 seconds (10 minutes). After this time, unacknowledged messages are automatically deleted by the Google platform. Please keep in mind that Google may charge you for message retention beyond this duration. The predefined duration of 600 seconds should prevent you from incurring any charges from Google. However, this cannot be guaranteed! Please also note that Google may change this policy in the future. The developer(s) of this adapter are in no way responsible for any costs that may arise from the use of this adapter!

Current development status, limitations & future goals

In its current state of development the adapter (after beeing correctly set up) should be able to...

• acquire a list of your Google Home (Nest) devices and create an ioBroker device object for each device.
• retrieve the capabilities of each device, and store them into ioBroker states.
• acquire events such as 'motion detected', 'doorbell press detected', etc., by regularly pulling data from the Google 'Pub/Sub system'. (see section 'Supported devices' for more details about the events implementation status).

In its current state of development the adapter is NOT capable of...

• acquiring camera images, preview clips, or live streams.
• retrieving status updates like 'current ambient temperature', 'current ambient humidity', etc., for devices.
• sending commands like 'set heat', 'set cool', 'set timer', etc. to the devices.

Future Goals:

It is intended to implement all of the above-mentioned missing capabilities. In addition to that, it is also intended to add the possibility to acquire events with a 'PUSH' system. However, the feasibility of each of these goals is subject to change.

Documentation

Coming very soon!

Supported devices

Camera devices

| Device name / description | general implementation | retrieve capabilities | retrieve status | receive events | send commands | | ------------------------------------------ | ---------------------- | --------------------- | ---------------- | -------------- | ------------- | | Google Nest Cam Indoor (legacy device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Cam Outdoor (legacy device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Cam IQ Indoor (legacy device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Cam IQ Outdoor (legacy device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Cam Indoor (battery device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Cam Outdoor (battery device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Cam Indoor (wired device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Cam with floodlight | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌

Doorbell devices

| Device name / description | general implementation | retrieve capabilities | retrieve status | receive events | send commands | | ------------------------------------------ | ---------------------- | --------------------- | ---------------- | -------------- | ------------- | | Google Nest Doorbell (legacy device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Doorbell (bettery device) | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ | | Google Nest Doorbell (wired device) | ✅ | ✅ | NONW AVAILABLE | ✅ | ❌ |

Display devices

| Device name / description | general implementation | retrieve capabilities | retrieve status | receive events | send commands | | ------------------------------------------ | ---------------------- | --------------------- | ---------------- | -------------- | ------------- | | Google Nest Hub Max | ✅ | ✅ | NONE AVAILABLE | ✅ | ❌ |

Thermostat devices

| Device name / description | general implementation | retrieve capabilities | retrieve status | receive events | send commands | | ------------------------------------------ | ---------------------- | --------------------- | ---------------- | -------------- | ------------- | | Google Nest Thermostat devices | ✅ | ❌ | ❌ | NONE AVAILABLE | ❌ |

DISCLAIMER

The developers of this module are in no way endorsed by or affiliated with Google LLC, or any associated subsidiaries, logos, or trademarks. The Google logo used in this adapter is for illustrative purposes only and is the property of Google LLC. If there are any concerns regarding the use of copyrighted materials in this adapter, please feel free to contact the developers, and they will promptly address them.

LIMITATION OF LIABILITY

The developers of this adapter shall not be liable for any damages or issues that arise from the use of the adapter, including but not limited to loss of data, malfunction, or any other damages or issues. By using this adapter, you agree that the developers are not responsible for any costs, damages, or issues that may arise from its use.

USAGE AGREEMENT

By using this adapter, you agree to the following terms:

• You may use this adapter for personal or commercial purposes.
• You may modify the adapter for your own use, but you may not redistribute it without permission from the developers.
• The adapter is provided "as is" without any warranty, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement.
• The developers of this adapter reserve the right to update, modify, or discontinue the adapter at any time without prior notice.
• Any feedback or contributions provided by users are greatly appreciated but are not mandatory.
• The developers of this adapter shall not be liable for any costs, damages, or issues that may arise from its use.

Changelog

0.3.0 (2024-05-12)

• (Daniel Drießen) Added important information to the README file.
• (Daniel Drießen) Added basic setup documentation in german and english.
• (Daniel Drießen) Removed automatic deletion of all stored device objects upon adapter start.
• (Daniel Drießen) Added automatic deletion of all stored device objects that can't be found online.
• (Daniel Drießen) Added option to recreate device object structure upon next adapter start.

0.2.0 (2024-05-02)

• (Daniel Drießen) Improved admin panel and corrected some text.
• (Daniel Drießen) Added missing translations on the admin panel.

0.1.2 (2024-04-30)

• (Daniel Drießen) Modified admin panel
• (Daniel Drießen) Changed 'redirectURI' back to 'localhost'

0.1.2-beta.0 (2024-04-29)

• (Daniel Drießen) Modified Readme file

0.1.1-beta.0 (2024-04-29)

• (Daniel Drießen) Corrected dependencies.

0.1.0-beta.0 (2024-04-28)

• (Daniel Drießen) Initial beta version release

0.0.1 (2023-16-23)

• (Daniel Drießen) Initial (unreleased) version

License

MIT License

Copyright (c) 2023-2024 Daniel Drießen [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.