Stay organized with collections
Save and categorize content based on your preferences.
CameraImage Schema
Nest Cam (legacy)
Nest Hub Max
Nest Doorbell (legacy)
sdm.devices.traits.CameraImage
This trait belongs to any device that supports taking images.
Fields
ImageResolution (maxImageResolution)
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.CameraImage
" : {
"maxImageResolution" : {
"width" : 1280,
"height" : 960
}
}
}
}
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\u003eCameraImage\u003c/code\u003e trait applies to Nest devices that can capture images, such as Nest Cam (legacy), Nest Hub Max, and Nest Doorbell (legacy).\u003c/p\u003e\n"],["\u003cp\u003eThis trait provides information about the maximum supported image resolution for the device through the \u003ccode\u003emaxImageResolution\u003c/code\u003e field which includes width and height.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve image resolution information using a GET request to the device's endpoint, which will return a JSON response containing the \u003ccode\u003emaxImageResolution\u003c/code\u003e data within the \u003ccode\u003esdm.devices.traits.CameraImage\u003c/code\u003e trait.\u003c/p\u003e\n"],["\u003cp\u003eThere are no specific commands associated with the \u003ccode\u003eCameraImage\u003c/code\u003e trait, it primarily serves to provide image resolution details.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nCameraImage Schema\n==================\n\n[Nest Cam (legacy)](/nest/device-access/api/camera) [Nest Hub Max](/nest/device-access/api/display) [Nest Doorbell (legacy)](/nest/device-access/api/doorbell)\n\n`sdm.devices.traits.CameraImage`\n\nThis trait belongs to any device that supports taking images.\n\n\u003cbr /\u003e\n\nFields\n------\n\n\n| Field | Description | Data Type |\n|----------------------|---------------------------------------------|-------------------------------------|\n| `maxImageResolution` | Maximum image resolution that is supported. | [ImageResolution](#imageresolution) |\n\n### ImageResolution (maxImageResolution)\n\n| Field | Description | Data Type |\n|----------|---------------------------------------------------------------------------------------------|-----------------------|\n| `width` | Maximum image resolution width. May also be used as a query parameter in the download URL. | `int32` Example: 1280 |\n| `height` | Maximum image resolution height. May also be used as a query parameter in the download URL. | `int32` Example: 960 |\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.CameraImage\" : {\n \"maxImageResolution\" : {\n \"width\" : 1280,\n \"height\" : 960\n }\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"]]
