REST Resource: enterprises.devices
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: Appareil
La ressource d'appareil représente une instance d'appareil géré par l'entreprise dans la propriété.
Représentation JSON |
{
"name": string,
"type": string,
"traits": {
object
},
"parentRelations": [
{
object (ParentRelation )
}
]
} |
Champs |
name |
string
Obligatoire. Nom de ressource de l'appareil. Par exemple : "enterprises/XYZ/devices/123".
|
type |
string
Uniquement en sortie. Type d'appareil utilisé pour l'affichage général. Par exemple : "Thermostat Thermostat". Le type d'appareil ne doit pas être utilisé pour déduire ou déduire les fonctionnalités de l'appareil auquel il est attribué. Utilisez plutôt les caractéristiques renvoyées pour l'appareil.
|
traits |
object (Struct format)
Uniquement en sortie. Traits d'appareil.
|
parentRelations[] |
object (ParentRelation )
Informations sur la personne responsable de l'appareil
|
ParentRelation
Représente les relations entre les appareils, par exemple la structure/la pièce à laquelle l'appareil est attribué.
Représentation JSON |
{
"parent": string,
"displayName": string
} |
Champs |
parent |
string
Uniquement en sortie. Nom de la relation (structure/pièce à laquelle l'appareil est attribué, par exemple). Par exemple : "entreprise/XYZ/structures/ABC" ou "entreprises/XYZ/structures/ABC/salles/123"
|
displayName |
string
Uniquement en sortie. Nom personnalisé de la relation (structure/pièce à laquelle l'appareil est attribué, par exemple).
|
Méthodes |
|
Exécute une commande sur l'appareil géré par l'entreprise. |
|
Obtient un appareil géré par l'entreprise. |
|
Liste les appareils gérés par l'entreprise. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]