REST Resource: enterprises.devices
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: Device
El recurso de dispositivo representa una instancia de un dispositivo administrado por una empresa en la propiedad.
Representación JSON |
{
"name": string,
"type": string,
"traits": {
object
},
"parentRelations": [
{
object (ParentRelation )
}
]
} |
Campos |
name |
string
Obligatorio. Es el nombre del recurso del dispositivo. Por ejemplo: “empresas/XYZ/dispositivos/123”.
|
type |
string
Solo salida. Tipo de dispositivo para fines de visualización general. Por ejemplo: “THERMOSTAT”. El tipo de dispositivo no debe usarse para deducir ni inferir la funcionalidad del dispositivo real al que está asignado. En su lugar, usa las características que se muestran para el dispositivo.
|
traits |
object (Struct format)
Solo salida. Traits del dispositivo.
|
parentRelations[] |
object (ParentRelation )
Son los detalles del usuario asignado del dispositivo.
|
ParentRelation
Representa las relaciones de los dispositivos, por ejemplo, la estructura o la habitación a la que está asignado el dispositivo.
Representación JSON |
{
"parent": string,
"displayName": string
} |
Campos |
parent |
string
Solo salida. El nombre de la relación, p.ej., estructura o habitación a la que se asigna el dispositivo. Por ejemplo: “empresas/XYZ/estructuras/ABC” o “empresas/XYZ/structures/ABC/rooms/123”
|
displayName |
string
Solo salida. El nombre personalizado de la relación, p.ej., estructura o habitación a la que se asigna el dispositivo.
|
Métodos |
|
Ejecuta un comando para el dispositivo administrado por la empresa. |
|
Obtiene un dispositivo administrado por la empresa. |
|
Muestra una lista de los dispositivos que administra la empresa. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]