Google Home

Integrate Google Home into the Droplit System

Configure Droplit Google Home Integration

  1. On the Droplit portal, go to the Integrations tab.
  2. Under "Platforms", select Google Home.
  3. Select Install to install the conduit.
  4. Since information from the portal will be needed to configure the Google Home Action, be sure to keep it open.
12801280

The Google Home Integration page on the Droplit portal as it initially appears.

Configure Google Home Action

  1. Sign into the Google Actions console using a Google account.
  2. Select Add/import project.
  3. Name it after your company with regard to Droplit.

📘

NOTE

The name of the project will not be public, and it should not just be the name of your company.

  1. Select the category Home control, and select the project type Smart home.
  2. Be sure to fill in the other sections as they pertain to you. Droplit-specific configuration is only present in the Account Linking and Actions sections.

Account Linking

  1. Select Account Linking toward the bottom of the sidebar under "ADVANCED OPTIONS".
  2. Under "Account creation", select: No, I only want to allow account creation on my website
  3. Linking type: OAuth.
  4. Grant Type: Authorization Code.
  5. Client ID, Client Secret, Authorization URL, and Token URL are all copied from the Google Home Integrations page on the Droplit portal.
  6. No scopes are necessary for this setup, so the "Scopes" field may be left blank.
  7. The "Testing Instructions" field may be filled out as you see fit.
12801280

The "Client information" part of the "Account linking" section where all of the fields are properly populated with data from the Droplit portal.

Actions

  1. Select Actions from the sidebar under "BUILD".
  2. Select ADD YOUR FIRST ACTION.
  3. Copy the "Fulfillment URL" from the Google Home integration configuration page on the Droplit portal, and paste it into the "Add fulfillment URL" field on the Actions page.
  4. Select DONE.
12801280

The new action's page with the fulfillment URL correctly copied from the Droplit portal.

🚧

WARNING

When testing the action, changes will not take effect until the TEST button is selected for the Droplit action on the Actions tab.

Google Home Features Supported by Droplit

Report State

Implementing Report State allows a device to report its state to Google's Home Graph rather than wait to be queried by the Google Home. This expedites the execution of Google Home commands because only the Home Graph needs to be referenced rather than waiting for several independent queries to be resolved. A device is configured to report its state whenever one of its service properties changes. For more information, see Google's documentation on Report State. Follow the below instructions to enable Report State.

Create New Google Cloud Project

  1. Login to Google's Cloud Console.

🚧

CAUTION

When following the link to the Cloud Console, ensure that you are logged into the same Google account with which the action was created.

  1. Create a project by selecting NEW PROJECT from the dropdown on the top menu bar.
  2. Navigate to the new project's page.
  3. Under the "APIs" section, select Go to APIs overview.
12801280

The dashboard of the API page for the newly created Google Cloud project.

Enable the Home Graph API

  1. From the dashboard, select ENABLE APIS AND SERVICES.
  2. Go to the HomeGraph API page, and select ENABLE.

🚧

CAUTION

When following the link to the HomeGraph API page, ensure that you are logged into the same Google account with which the project was created and that the correct project is selected.

Establish Credentials

  1. From the APIs & Services menu on Google's Cloud Console, select Credentials.
12801280

The "Credentials" tab on the API page for the project.

  1. Select Create credentials, then select Service account key.
  2. Select a service account, or create a new one:
  3. Select a "Service account name" that best pertains to your needs.
  4. For "Role", select Security Review under "IAM" from the dropdown menu.
  5. For "Key type", select JSON.
  6. Select Create.
12801280

The "Create service account key" page filled out with sample information for creating a new service account.

Enable Report State

  1. Copy the raw data of the newly downloaded JSON object; it contains the created credentials.
  2. On the Droplit portal, navigate to the Google Home Integration page.
  3. Enable Report State.
  4. Paste the copied JSON object into the "Service Account Key" field, and select Save & apply.
12801280

The Google Home Integrations page on the Droplit portal with all of the fields correctly filled out for enabling report stare functionality.

SYNC Request

A SYNC Request asks Google to send a SYNC call to all devices associated with the identifier sent in the request. This enables a user's devices to be updated without having to unlink and relink their account. A SYNC request is made whenever a device is created, updated, or deleted within the environment in which the Google Home conduit has been activated. More information can be found on Google's documentation for Request Sync.

FAQ

Set the logo of an Action

  1. Login to Actions on Google.
  2. Select the desired Action.
  3. Under the "DEPLOY" section of the sidebar, select Directory information.
  4. Select Images.
  5. Select the photo icons to upload the desired images, as shown below.
  6. Once the desired photos are uploaded, select SAVE.
12801280

The "Images" section of the "Directory information" tab on the sidebar with the Droplit logo saved into the "Small logo" category.