Google Home Integration¶

Supported Google Home Commands¶

Currently, we provide the following voice commands to interact with Google Home.

On/off¶

"Ok Google, turn on the <device name>"

"Ok Google, turn off the <device name>"

Percentage¶

"Ok Google, set <device name> to <number> percent"

"Ok Google, set <device name> to maximum"

"Ok Google, set <device name> to minimum"

Fan Speed¶

"Ok Google, set to <speed_synonym>"

"Ok Google, turn to <speed_synonym>"

"Ok Google, up <device name> speed"

"Ok Google, increase <device name> speed"

"Ok Google, make <device name> speed higher"

"Ok Google, down <device name> speed"

"Ok Google, decrease <device name> speed"

"Ok Google, make <device name> speed lower"

"Ok Google, what is <device name> speed"

"Ok Google, turn <device name> to reverse"

Color Temperature¶

"Ok Google, set the <device name> to candle light"

"Ok Google, set the <device name> to incandescent"

"Ok Google, set the <device name> to soft white/ warm white"

"Ok Google, set the <device name>to cool white"

"Ok Google, set the <device name> to white/daylight/ daylight white"

"Ok Google, set the <device name> to ivory"

Modes¶

"Ok Google, set <device name> to <mode>

Temperature Setting¶

"Ok Google, set <device name> to <number> degree."

Create a Cloud-to-Cloud Project¶

Log in to your Google account on Google Home Developer Console, where you may find Create a Project button and your existing projects.

Project Settings¶

1. On project home page, click + Add cloud-to-cloud integration at the bottom, or open navigation menu on the left and go to: Cloud-to-cloud > Develop > click Add integration.
2. Follow the on-screen instruction, click through the Next: Develop and Next: Setup buttons to the "Setup & configuration" page.
3. Enter the integration name and choose device type. e.g. AC unit, Light.
4. Upload a 144x144px App icon in jpg or png format (round logo, file name must be the project ID. Refer to this page for more details).
5. Please provide your "Project id" to Exosite by sending a mail to support+hamv@exosite.com or your main contact window. Exosite will set up an Oauth Client for you.
6. Complete the account linking info and save:
   • OAuth Client ID and Client secret: Provided by Exosite.
   • Authorization URL: https://<Your domain name>.apps.exosite.io/oauth2/authorize/googlehome
   • Token URL: https://<Your domain name>.apps.exosite.io/oauth2/token/googlehome
   • Cloud fulfillment URL: https://<Your domain name>.apps.exosite.io/api:1/googlehome
   • Local fulfillment: disabled
   • App flip: disabled
   • Scope(s): profile
7. Submit company info (name, website, a 192x192 px logo, privacy policy, contact info…)

You may refer to Google Home cloud-to-cloud ducument for more detail settings.

Testing¶

Prerequisite¶

Before using the integration, please upload corresponding information model with Integration Schema filled in to the Admin Site. Provision a testing device to your ExoHome App.

Steps¶

1. Log in to Google Home App on the mobile phone and link the cloud-to-cloud integration you just setup.

   Please make sure that your Google Home account is a project member.

   You can follow Google Home instruction to control devices via Google Home.

2. Go back to the Developer console. In the navigation menu on the left, go to Cloud-to-cloud > Test.

3. In the "Ready to test" list, find your target test integration and click Test.
4. Configure the test plan and start testing.

Certification and Launch¶

Once the integration is tested and is good to go, you need to submit it for release. Please follow the Google instructions.

Please note that Google will need some time to review your project. You can always check the status in the Developer console.

For manual test, you can follow Google Home instruction to control devices via Google Home.

Problem Shooting¶

If you run into any issues (e.g. not being able to control devices), try to do one of the following actions:

• Unlink the action and re-link it again.
• Change the IAM permission (make it higher).
• Remove the permission and re-add it again.
• Provide the simulator link to the user

Enable Report State¶

To publish Google Home cloud-to-cloud integration, you need to enable Report State for your solution. Please follow Google Home instruction, "Get started" section to create a service account key. After the service account key is created, please provide "client_email" and "private_key" (you can find it from the service account key file(.json)) to Exosite by sending a mail to support@exosite.com.

Have more questions? Submit a request