Smart Device Management API
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Разрешите избранным корпоративным партнерам получать доступ к устройствам Google и Nest, а также управлять ими программным способом.
Сервис: smartdevicemanagement.googleapis.com.
Для вызова этой службы мы рекомендуем использовать клиентские библиотеки Google. Если вашему приложению необходимо использовать собственные библиотеки для вызова этой службы, используйте следующую информацию при отправке запросов API.
Документ открытия
Документ обнаружения — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Одна служба может предоставлять несколько документов обнаружения. Эта служба предоставляет следующий документ обнаружения:
Конечная точка службы
Конечная точка службы — это базовый URL-адрес, указывающий сетевой адрес службы API. Одна служба может иметь несколько конечных точек службы. Эта служба имеет следующую конечную точку службы, и все приведенные ниже URI относятся к этой конечной точке службы:
-
https://smartdevicemanagement.googleapis.com
| Методы |
|---|
executeCommand | POST /v1/{name=enterprises/*/devices/*}:executeCommand
Выполняет команду устройству, управляемому предприятием. |
get | GET /v1/{name=enterprises/*/devices/*}
Получает устройство, управляемое предприятием. |
list | GET /v1/{parent=enterprises/*}/devices
Перечисляет устройства, управляемые предприятием. |
| Методы |
|---|
get | GET /v1/{name=enterprises/*/structures/*}
Получает структуру, управляемую предприятием. |
list | GET /v1/{parent=enterprises/*}/structures
Перечисляет структуры, находящиеся под управлением предприятия. |
| Методы |
|---|
get | GET /v1/{name=enterprises/*/structures/*/rooms/*}
Получает помещение, управляемое предприятием. |
list | GET /v1/{parent=enterprises/*/structures/*}/rooms
Перечисляет помещения, находящиеся в ведении предприятия. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[[["\u003cp\u003eThe Smart Device Management API enables select enterprise partners to programmatically access, control, and manage Google and Nest devices.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the provided REST resources for interacting with devices, structures, and rooms within the enterprise environment.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers methods for executing commands on devices, retrieving device details, and listing devices, structures, and rooms.\u003c/p\u003e\n"],["\u003cp\u003eGoogle-provided client libraries are recommended for seamless integration with the service.\u003c/p\u003e\n"],["\u003cp\u003eA discovery document and service endpoint are available to facilitate interaction with the API.\u003c/p\u003e\n"]]],["Enterprise partners can use the `smartdevicemanagement.googleapis.com` service to interact with Google and Nest devices. This involves using REST APIs to manage devices, structures, and rooms. Key actions include: executing commands on devices via `executeCommand`, retrieving device details with `get`, and listing devices via `list`. Additionally, structures and rooms can be accessed and listed using `get` and `list` methods. The service uses a discovery document and a defined service endpoint for interaction.\n"],null,["# Smart Device Management API\n\nAllow select enterprise partners to access, control, and manage Google and Nest devices programmatically.\n\n- [REST Resource: v1.enterprises.devices](#v1.enterprises.devices)\n- [REST Resource: v1.enterprises.structures](#v1.enterprises.structures)\n- [REST Resource: v1.enterprises.structures.rooms](#v1.enterprises.structures.rooms)\n\nService: smartdevicemanagement.googleapis.com\n---------------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://smartdevicemanagement.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://smartdevicemanagement.googleapis.com`\n\nREST Resource: [v1.enterprises.devices](/nest/device-access/reference/rest/v1/enterprises.devices)\n--------------------------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|\n| [executeCommand](/nest/device-access/reference/rest/v1/enterprises.devices/executeCommand) | `POST /v1/{name=enterprises/*/devices/*}:executeCommand` Executes a command to device managed by the enterprise. |\n| [get](/nest/device-access/reference/rest/v1/enterprises.devices/get) | `GET /v1/{name=enterprises/*/devices/*}` Gets a device managed by the enterprise. |\n| [list](/nest/device-access/reference/rest/v1/enterprises.devices/list) | `GET /v1/{parent=enterprises/*}/devices` Lists devices managed by the enterprise. |\n\nREST Resource: [v1.enterprises.structures](/nest/device-access/reference/rest/v1/enterprises.structures)\n--------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|\n| [get](/nest/device-access/reference/rest/v1/enterprises.structures/get) | `GET /v1/{name=enterprises/*/structures/*}` Gets a structure managed by the enterprise. |\n| [list](/nest/device-access/reference/rest/v1/enterprises.structures/list) | `GET /v1/{parent=enterprises/*}/structures` Lists structures managed by the enterprise. |\n\nREST Resource: [v1.enterprises.structures.rooms](/nest/device-access/reference/rest/v1/enterprises.structures.rooms)\n--------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| [get](/nest/device-access/reference/rest/v1/enterprises.structures.rooms/get) | `GET /v1/{name=enterprises/*/structures/*/rooms/*}` Gets a room managed by the enterprise. |\n| [list](/nest/device-access/reference/rest/v1/enterprises.structures.rooms/list) | `GET /v1/{parent=enterprises/*/structures/*}/rooms` Lists rooms managed by the enterprise. |"]]
