Stay organized with collections
Save and categorize content based on your preferences.
Info Schema
Nest Cam (legacy)
Nest Cam (outdoor or indoor, battery)
Nest Cam with floodlight
Nest Cam (indoor, wired)
Nest Hub Max
Nest Doorbell (legacy)
Nest Doorbell (battery)
Nest Doorbell (wired)
Nest Thermostat
sdm.devices.traits.Info
This trait belongs to any device for device-related 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.Info
" : {
"customName" : "My device"
}
}
}
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.Info\u003c/code\u003e trait provides device-related information like the custom name, which is the label shown in the Nest App.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve device information, including the custom name, by sending a GET request to \u003ccode\u003e/enterprises/project-id/devices/device-id\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThis trait is applicable to a variety of Nest devices such as cameras, doorbells, thermostats, and displays.\u003c/p\u003e\n"],["\u003cp\u003eThere are no specific commands associated with the \u003ccode\u003esdm.devices.traits.Info\u003c/code\u003e trait, it is primarily used for retrieving device details.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nInfo Schema\n===========\n\n[Nest Cam (legacy)](/nest/device-access/api/camera) [Nest Cam (outdoor or indoor, battery)](/nest/device-access/api/camera-battery) [Nest Cam with floodlight](/nest/device-access/api/camera-floodlight) [Nest Cam (indoor, wired)](/nest/device-access/api/camera-wired) [Nest Hub Max](/nest/device-access/api/display) [Nest Doorbell (legacy)](/nest/device-access/api/doorbell) [Nest Doorbell (battery)](/nest/device-access/api/doorbell-battery) [Nest Doorbell (wired)](/nest/device-access/api/doorbell-wired) [Nest Thermostat](/nest/device-access/api/thermostat)\n\n`sdm.devices.traits.Info`\n\nThis trait belongs to any device for device-related information.\n\n\u003cbr /\u003e\n\nFields\n------\n\n\n| Field | Description | Data Type |\n|--------------|-----------------------------------------------------------------------------------------|-------------------------------|\n| `customName` | Custom name of the device. Corresponds to the Label value for a device in the Nest App. | `string` Example: \"My device\" |\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.Info\" : {\n \"customName\" : \"My device\"\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"]]
