REST Resource: enterprises.devices
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: מכשיר
משאב המכשיר מייצג מופע של מכשיר שמנוהל על ידי ארגון בנכס.
| ייצוג JSON |
{
"name": string,
"type": string,
"traits": {
object
},
"parentRelations": [
{
object (ParentRelation)
}
]
} |
| שדות |
name |
string
חובה. שם המשאב של המכשיר. לדוגמה: "enterprises/XYZ/devices/123".
|
type |
string
פלט בלבד. סוג המכשיר למטרות תצוגה כלליות. לדוגמה: "TheRmostAT". אין להשתמש בסוג המכשיר כדי להסיק או להסיק את הפונקציונליות של המכשיר שאליו הוא מוקצה בפועל. במקום זאת, צריך להשתמש בתכונות שהוחזרו למכשיר.
|
traits |
object (Struct format)
פלט בלבד. תכונות המכשיר.
|
parentRelations[] |
object (ParentRelation)
פרטי המכשיר שהמשימה הוקצתה לו.
|
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 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
