Smart Device Management API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
일부 엔터프라이즈 파트너가 Google 및 Nest 기기에 프로그래매틱 방식으로 액세스, 제어, 관리하도록 허용합니다.
서비스: smartdevicemanagement.googleapis.com
이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션이 이 서비스를 호출하기 위해 자체 라이브러리를 사용해야 하는 경우, API 요청을 할 때 다음 정보를 사용합니다.
검색 문서
검색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참조할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 검색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.
서비스 엔드포인트
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기본 URL입니다. 하나의 서비스에 여러 서비스 엔드포인트가 있을 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 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 Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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. |"]]
