v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1352926.5 KB
devices

Reports device state and optionally sends device notifications. Called by your smart home Action when the state of a third-party device changes or you need to send a notification about the device. See Implement Report State for more information. This method updates the device state according to its declared traits. Publishing a new state value outside of these traits will result in an INVALID_ARGUMENT error response. The third-party user's identity is passed in via the agent_user_id (see ReportStateAndNotificationRequest). This request must be authorized using service account credentials from your Actions console project.

post/v1/devices:reportStateAndNotification

Request body

eventIdstring

Unique identifier per event (for example, a doorbell press).

followUpTokenstring

Deprecated.

requestIdstring

Request ID used for debugging.

agentUserIdstring

Required. Third-party user ID.

Response

Successful response

All 5 operations