REST Resource: enterprises.devices
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: الجهاز
يمثّل مورد الجهاز مثيلاً لجهاز مُدار من مؤسسة في الموقع.
| تمثيل JSON |
{
"name": string,
"type": string,
"traits": {
object
},
"parentRelations": [
{
object (ParentRelation)
}
]
} |
| الحقول |
name |
string
مطلوب. اسم المورد للجهاز. على سبيل المثال: "المؤسسات/XYZ/الأجهزة/123".
|
type |
string
النتائج فقط. نوع الجهاز المستخدَم لأغراض العرض العامة على سبيل المثال: "درجة الحرارة" يجب عدم استخدام نوع الجهاز لاستنتاج أو استنتاج وظيفة الجهاز الذي تم تخصيصه له. بدلاً من ذلك، استخدِم السمات التي تم إرجاعها للجهاز.
|
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 (حسب التوقيت العالمي المتفَّق عليه)
[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. |"]]
