REST Resource: enterprises.devices
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Thiết bị
Tài nguyên thiết bị đại diện cho một thực thể của thiết bị do doanh nghiệp quản lý trong tài sản.
Biểu diễn dưới dạng JSON |
{
"name": string,
"type": string,
"traits": {
object
},
"parentRelations": [
{
object (ParentRelation )
}
]
} |
Trường |
name |
string
Bắt buộc. Tên tài nguyên của thiết bị. Ví dụ: "enterprises/XYZ/devices/123".
|
type |
string
Chỉ có đầu ra. Loại thiết bị dùng cho mục đích hiển thị chung. Ví dụ: "THERmostAT". Không được dùng loại thiết bị để suy ra hoặc suy luận chức năng của thiết bị thực tế được chỉ định. Thay vào đó, hãy sử dụng các trait được trả về cho thiết bị.
|
traits |
object (Struct format)
Chỉ có đầu ra. Trait của thiết bị.
|
parentRelations[] |
object (ParentRelation )
Thông tin chi tiết về thiết bị được giao cho người được giao.
|
ParentRelation
Biểu thị các mối quan hệ của thiết bị, chẳng hạn như cấu trúc/phòng mà thiết bị được chỉ định.
Biểu diễn dưới dạng JSON |
{
"parent": string,
"displayName": string
} |
Trường |
parent |
string
Chỉ có đầu ra. Tên của mối quan hệ – ví dụ: cấu trúc/phòng nơi thiết bị được chỉ định. Ví dụ: "enterprises/XYZ/structures/ABC" hoặc "enterprises/XYZ/structures/ABC/rooms/123"
|
displayName |
string
Chỉ có đầu ra. Tên tuỳ chỉnh của mối quan hệ – ví dụ: cấu trúc/phòng nơi thiết bị được chỉ định.
|
Phương thức |
|
Thực thi một lệnh tới thiết bị do doanh nghiệp quản lý. |
|
Tải một thiết bị do doanh nghiệp quản lý. |
|
Liệt kê các thiết bị do doanh nghiệp quản lý. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\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. |"]]