REST Resource: enterprises.devices
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع: دستگاه
منبع دستگاه نمونه ای از دستگاه مدیریت شده سازمانی را در ویژگی نشان می دهد.
| نمایندگی JSON |
|---|
{
"name": string,
"type": string,
"traits": {
object
},
"parentRelations": [
{
object (ParentRelation)
}
]
} |
| فیلدها |
|---|
name | string مورد نیاز. نام منبع دستگاه به عنوان مثال: "enterprises/XYZ/devices/123". |
type | string فقط خروجی نوع دستگاه برای اهداف نمایش عمومی. به عنوان مثال: "ترموستات". نوع دستگاه نباید برای استنباط یا استنتاج عملکرد دستگاه واقعی که به آن اختصاص داده شده است استفاده شود. در عوض، از ویژگی های برگشتی برای دستگاه استفاده کنید. |
traits | object ( Struct format) فقط خروجی ویژگی های دستگاه |
parentRelations[] | object ( ParentRelation ) مشخصات دستگاه. |
رابطه والدین
روابط دستگاه را نشان می دهد، به عنوان مثال، ساختار/اتاقی که دستگاه به آن اختصاص داده شده است.
| نمایندگی JSON |
|---|
{
"parent": string,
"displayName": string
} |
| فیلدها |
|---|
parent | string فقط خروجی نام رابطه -- به عنوان مثال، ساختار/اتاقی که دستگاه به آن اختصاص داده شده است. به عنوان مثال: "Enterprises/XYZ/structures/ABC" یا "Enterprises/XYZ/structures/ABC/rooms/123" |
displayName | string فقط خروجی نام سفارشی رابطه -- به عنوان مثال، ساختار/اتاقی که دستگاه به آن اختصاص داده شده است. |
روش ها |
|---|
| یک فرمان را به دستگاهی که توسط شرکت مدیریت می شود اجرا می کند. |
| دستگاهی را دریافت می کند که توسط شرکت مدیریت می شود. |
| دستگاه های مدیریت شده توسط شرکت را فهرست می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Device resource represents an instance of an enterprise-managed device, containing information like name, type, traits, and parent relationships.\u003c/p\u003e\n"],["\u003cp\u003eParentRelation describes the relationship of a device to a structure or room within the enterprise, including its parent and display name.\u003c/p\u003e\n"],["\u003cp\u003eThis API provides methods to execute commands on devices, retrieve device details, and list devices managed by the enterprise.\u003c/p\u003e\n"]]],[],null,["# REST Resource: enterprises.devices\n\n- [Resource: Device](#Device)\n - [JSON representation](#Device.SCHEMA_REPRESENTATION)\n- [ParentRelation](#ParentRelation)\n - [JSON representation](#ParentRelation.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Device\n----------------\n\nDevice resource represents an instance of enterprise managed device in the property.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"type\": string, \"traits\": { object }, \"parentRelations\": [ { object (/nest/device-access/reference/rest/v1/enterprises.devices#ParentRelation) } ] } ``` |\n\n| Fields ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The resource name of the device. For example: \"enterprises/XYZ/devices/123\". |\n| `type` | `string` Output only. Type of the device for general display purposes. For example: \"THERMOSTAT\". The device type should not be used to deduce or infer functionality of the actual device it is assigned to. Instead, use the returned traits for the device. |\n| `traits` | `object (`[Struct](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Struct)` format)` Output only. Device traits. |\n| `parentRelations[]` | `object (`[ParentRelation](/nest/device-access/reference/rest/v1/enterprises.devices#ParentRelation)`)` Assignee details of the device. |\n\nParentRelation\n--------------\n\nRepresents device relationships, for instance, structure/room to which the device is assigned to.\n\n| JSON representation |\n|-----------------------------------------------------|\n| ``` { \"parent\": string, \"displayName\": string } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Output only. The name of the relation -- e.g., structure/room where the device is assigned to. For example: \"enterprises/XYZ/structures/ABC\" or \"enterprises/XYZ/structures/ABC/rooms/123\" |\n| `displayName` | `string` Output only. The custom name of the relation -- e.g., structure/room where the device is assigned to. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------------|---------------------------------------------------------|\n| ### [executeCommand](/nest/device-access/reference/rest/v1/enterprises.devices/executeCommand) | Executes a command to device managed by the enterprise. |\n| ### [get](/nest/device-access/reference/rest/v1/enterprises.devices/get) | Gets a device managed by the enterprise. |\n| ### [list](/nest/device-access/reference/rest/v1/enterprises.devices/list) | Lists devices managed by the enterprise. |"]]
