Stay organized with collections
Save and categorize content based on your preferences.
Settings Schema
Nest Thermostat
sdm.devices.traits.Settings
This trait belongs to any device for device-related settings information.
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.Settings
" : {
"temperatureScale" : "CELSIUS"
}
}
}
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 \u003ccode\u003esdm.devices.traits.Settings\u003c/code\u003e trait provides device-related settings information, specifically the temperature scale used by a Google Nest Thermostat.\u003c/p\u003e\n"],["\u003cp\u003eThis trait includes a \u003ccode\u003etemperatureScale\u003c/code\u003e field, indicating whether the thermostat displays temperature in Celsius or Fahrenheit.\u003c/p\u003e\n"],["\u003cp\u003eUsers can retrieve device settings, including the temperature scale, using a GET request to the device's endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe Settings trait does not offer any commands to modify device settings.\u003c/p\u003e\n"]]],["The `sdm.devices.traits.Settings` trait provides device-related settings information for a Nest Thermostat, specifically the `temperatureScale`. This field indicates the temperature format, which can be either \"CELSIUS\" or \"FAHRENHEIT\". A GET request to retrieve device information includes this trait, showing the current `temperatureScale`. No commands are available to modify these settings. The full list of error codes can be found in the API Error Code Reference.\n"],null,["\u003cbr /\u003e\n\nSettings Schema\n===============\n\n[Nest Thermostat](/nest/device-access/api/thermostat)\n\n`sdm.devices.traits.Settings`\n\nThis trait belongs to any device for device-related settings information.\n\n\u003cbr /\u003e\n\nFields\n------\n\n\n| Field | Description | Data Type |\n|--------------------|--------------------------------------------------------------|------------------------------------------|\n| `temperatureScale` | Format of the degrees displayed on a Google Nest Thermostat. | `string` Values: \"CELSIUS\", \"FAHRENHEIT\" |\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.Settings\" : {\n \"temperatureScale\" : \"CELSIUS\"\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"]]
