Googleapis Homegraph
Googleapis Homegraph is a connector for the Google Home Graph API used by smart home integrations to sync devices and report their states to Google Assistant.
- Base URL:
https://homegraph.googleapis.com - Auth: OAuth 2.0 (user-delegated) — attach an InTouch
oauthcredential. Mint one withitcli.py /oauth <provider>(device-code) or/google-auth(Google); the server auto-refreshes the access token before each run, so the connector never handles or stores tokens.
Operations
homegraph_devices_query— POST /v1/devices:query — Gets the current states in Home Graph for the given set of the third-party user'homegraph_devices_reportstateandnotification— POST /v1/devices:reportStateAndNotification — Reports device state and optionally sends device notifications. Called by your shomegraph_devices_requestsync— POST /v1/devices:requestSync — Requests Google to send anaction.devices.SYNC[intent](https://developers.homhomegraph_devices_sync— POST /v1/devices:sync — Gets all the devices associated with the given third-party user. The third-partyhomegraph_agentusers_delete— DELETE /v1/{agentUserId} — Unlinks the given third-party user from your smart home Action. All data related
Inputs
- a linked
oauthcredential (no key inputs) — the server injects a freshAuthorization: Bearerfrom it operation— one of the operations above- path parameters when an operation's path contains
{...} query— optional JSON object of query paramsbody— JSON object for create/update ops
Example
operation: homegraph_devices_query
# (attach an 'oauth' credential to the task — no inline secrets)
Publishes
The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.
erroroperationresultstatus
Input Properties
Every property this tool accepts, from its own tool.iml.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
operation |
string | yes | — | One of: homegraph_devices_query, homegraph_devices_reportstateandnotification, homegraph_devices_requestsync, homegraph_devices_sync, homegraph_agentusers_delete |
agentUserId |
string | no | — | Path parameter agentUserId (required by some operations). |
query |
string | no | — | Optional query params as a JSON object string, e.g. {"limit": 10}. |
body |
string | no | — | Request body as a JSON object string (for create/update operations). |