REST Resource: enterprises.devices
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: Gerät
Die Geräteressource stellt eine Instanz eines vom Unternehmen verwalteten Geräts in der Property dar.
JSON-Darstellung |
{
"name": string,
"type": string,
"traits": {
object
},
"parentRelations": [
{
object (ParentRelation )
}
]
} |
Felder |
name |
string
Erforderlich. Der Ressourcenname des Geräts. Beispiel: „enterprises/XYZ/devices/123“.
|
type |
string
Nur Ausgabe. Typ des Geräts für allgemeine Anzeigezwecke. Beispiel: „THERMOSTAT“. Der Gerätetyp sollte nicht verwendet werden, um die Funktionalität des tatsächlichen Geräts, dem es zugewiesen ist, abzuleiten oder abzuleiten. Verwende stattdessen die zurückgegebenen Traits für das Gerät.
|
traits |
object (Struct format)
Nur Ausgabe. Geräte-Traits
|
parentRelations[] |
object (ParentRelation )
Details zur zuständigen Person des Geräts.
|
ParentRelation
Stellt Gerätebeziehungen dar, z. B. die Struktur oder der Raum, dem das Gerät zugewiesen ist.
JSON-Darstellung |
{
"parent": string,
"displayName": string
} |
Felder |
parent |
string
Nur Ausgabe. Der Name der Beziehung, z.B. das Gebäude oder der Raum, dem das Gerät zugeordnet ist. Beispiel: „Unternehmen/XYZ/Strukturen/ABC“ oder „Unternehmen/XYZ/Gebäude/ABC/Zimmer/123“
|
displayName |
string
Nur Ausgabe. Der benutzerdefinierte Name der Beziehung, z.B. das Gebäude oder der Raum, dem das Gerät zugewiesen ist.
|
Methoden |
|
Führt einen Befehl auf dem Gerät aus, das vom Unternehmen verwaltet wird. |
|
Sie erhält ein vom Unternehmen verwaltetes Gerät. |
|
Listet die vom Unternehmen verwalteten Geräte auf. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]