Stay organized with collections
Save and categorize content based on your preferences.
Temperature Schema
Nest Thermostat
sdm.devices.traits.Temperature
This trait belongs to any device that has a sensor to measure temperature.
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.Temperature
" : {
"ambientTemperatureCelsius" : 23.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 \u003ccode\u003esdm.devices.traits.Temperature\u003c/code\u003e trait applies to devices with temperature sensors and provides the current temperature in Celsius.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eambientTemperatureCelsius\u003c/code\u003e field represents the device's measured temperature in degrees Celsius.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve a device's temperature by sending a GET request to its resource endpoint, which includes the \u003ccode\u003esdm.devices.traits.Temperature\u003c/code\u003e trait in the response if available.\u003c/p\u003e\n"],["\u003cp\u003eThis trait is read-only, meaning there are no commands to control or modify the temperature.\u003c/p\u003e\n"]]],["The `Temperature` trait, found in devices with temperature sensors, provides the `ambientTemperatureCelsius` field. This field reports the temperature in degrees Celsius measured at the device, as a number (e.g., 23.0). A GET request to a device's endpoint retrieves a response, including the device's name and its `Temperature` trait with the current `ambientTemperatureCelsius` reading. No commands are available for this trait, and API errors are listed in a separate reference.\n"],null,["\u003cbr /\u003e\n\nTemperature Schema\n==================\n\n[Nest Thermostat](/nest/device-access/api/thermostat)\n\n`sdm.devices.traits.Temperature`\n\nThis trait belongs to any device that has a sensor to measure temperature.\n\n\u003cbr /\u003e\n\nFields\n------\n\n\n| Field | Description | Data Type |\n|-----------------------------|---------------------------------------------------------|------------------------|\n| `ambientTemperatureCelsius` | Temperature in degrees Celsius, measured at the device. | `number` Example: 23.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.Temperature\" : {\n \"ambientTemperatureCelsius\" : 23.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"]]
