Stay organized with collections
Save and categorize content based on your preferences.
Humidity Schema
Nest Thermostat
sdm.devices.traits.Humidity
This trait belongs to any device that has a sensor to measure humidity.
Fields
Sample GET request and response
Request
GET /enterprises/ project-id
/devices/ device-id
Response
{
"name" : "enterprises/ project-id
/devices/ device-id
",
"traits" : {
" sdm.devices.traits.Humidity
" : {
"ambientHumidityPercent" : 35.0
}
}
}
Commands
There are no commands available for this trait.
Errors
See the API Error Code Reference
for
the full list of API error codes.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-25 UTC."],[[["\u003cp\u003eThe Humidity Schema applies to devices with humidity sensors and uses the \u003ccode\u003esdm.devices.traits.Humidity\u003c/code\u003e trait.\u003c/p\u003e\n"],["\u003cp\u003eIt provides a single field, \u003ccode\u003eambientHumidityPercent\u003c/code\u003e, representing the humidity percentage measured at the device.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the current humidity using a GET request to the device's endpoint, which returns the humidity percentage within the \u003ccode\u003esdm.devices.traits.Humidity\u003c/code\u003e trait.\u003c/p\u003e\n"],["\u003cp\u003eThere are no specific commands to control humidity through this trait.\u003c/p\u003e\n"]]],["The `sdm.devices.traits.Humidity` trait represents a device's humidity sensor. It has one field, `ambientHumidityPercent`, which indicates the percentage of humidity measured at the device, represented as a number. A GET request to the device's endpoint returns the `ambientHumidityPercent` within the `traits` field, showing the current humidity. No commands are available for this trait, only read information. Any errors can be found in the API error code.\n"],null,["\u003cbr /\u003e\n\nHumidity Schema\n===============\n\n[Nest Thermostat](/nest/device-access/api/thermostat)\n\n`sdm.devices.traits.Humidity`\n\nThis trait belongs to any device that has a sensor to measure humidity.\n\n\u003cbr /\u003e\n\nFields\n------\n\n\n| Field | Description | Data Type |\n|--------------------------|-------------------------------------------|------------------------|\n| `ambientHumidityPercent` | Percent humidity, measured at the device. | `number` Example: 35.0 |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n#### Sample GET request and response\n\n### Request\n\n```\nGET /enterprises/project-id/devices/device-id\n```\n\n### Response\n\n {\n \"name\" : \"enterprises/project-id/devices/device-id\",\n \"traits\" : {\n \"sdm.devices.traits.Humidity\" : {\n \"ambientHumidityPercent\" : 35.0\n }\n }\n }\n\n\u003cbr /\u003e\n\nCommands\n--------\n\nThere are no commands available for this trait.\n\n\nErrors\n------\n\nSee the [API Error Code Reference](/nest/device-access/reference/errors/api) for\nthe full list of API error codes.\n\n\u003cbr /\u003e"]]
