Device Access 프로젝트가 사용자, 구조, 비율 제한의 제한을 받는 경우 상용 서비스의 환경과 유형에 따라 달라질 수 있습니다.
Google은 개발자가 매력적인 사용자 환경을 조성하기를 원하면서도 Nest 서비스와 기기는 사용자가 항상 사용할 수 있습니다. Google이 제공하는 대량의 요청이 발생하면 서비스에 영향을 미치고 사용 가능하므로 SDM API는 비율 제한을 적용합니다. 비율 제한은 특정 기간 동안 API 호출 수를 제한하고 리소스의 초과 이용을 방지합니다
환경별 제한사항
모든 프로젝트는 샌드박스 환경에서 시작됩니다. 샌드박스는 SDM API 및 개인적 사용을 평가하기 위한 것이며 이에 따라 한도가 제한됩니다. 다음과 같이 사용자층이 더 큰 환경 상업적 개발 의 경우 다른 제한이 적용됩니다.
샌드박스 사용자 한도
샌드박스의 개발자 계정은 5명의 사용자 중 25명으로 제한됩니다. 프로젝트 수준에서 적용됩니다 계정당 프로젝트는 3개로 제한됩니다.
구조는 각각 5명의 사용자로 제한되므로 사용자 한도에만 도달합니다. 5개의 구조 모두 각각 5명의 사용자로 제한되면 개발자 계정 (프로젝트 소유자)는 프로젝트의 사용자 한도 5명에 포함되지 않고 있습니다.
반대로 5개의 구조에서 15명의 사용자가 프로젝트에 참여하는 경우에는 추가 사용자가 기존 5개의 집에만 추가할 수 있습니다. 이미 도달했습니다.
샌드박스 비율 제한
샌드박스는 3가지 수준에서 속도가 제한됩니다. 시간 제한 설정: 분당 쿼리 수 (QPM)로 계산됩니다.
API 수준
API 호출은 프로젝트 및 사용자별로 제한됩니다. API 참조 참고 자료를 참조하세요. 메서드를 참조하세요.
| API 메서드 | 비율 제한 |
|---|---|
devices.executeCommand |
10 QPM |
devices.get |
10 QPM |
devices.list |
5 QPM |
structures.get |
5 QPM |
structures.list |
5 QPM |
structures.rooms.get |
5 QPM |
structures.rooms.list |
5 QPM |
명령 수준
각 트레잇 명령어 (devices.executeCommand)는 프로젝트당 5QPM으로 제한됩니다.
사용자당 평균 수익입니다
즉, 프로젝트에 사용자 2명이 각각 2대의 기기 (총 4대의 기기)를 갖는 경우 해당 4대의 기기 각각에 대해 1분에 동일한 명령어를 5번 호출할 수 있습니다.
하지만 프로젝트에 사용자 2명이 각각 3개씩 총 6대의 기기를 가지고 있다면
같은 명령어를 1분에 5번씩 호출할 수 없다는 것은
기기에서 사용할 수 있습니다. 따라서
devices.executeCommand 프로젝트 사용자의 API 수준 비율 제한은 10QPM입니다.
기기 인스턴스 수준
또한 기기 인스턴스 수준 제한은 프로젝트 및
기기 배터리 보호를 위한 명령어 (devices.executeCommand) 이러한 한도
QPM 및 시간당 쿼리 수 (QPH) 수준에서 모두 적용되며
get 및 list API 메서드에 추가해야 합니다.
예를 들어 프로젝트 A와 프로젝트 B 모두 동일한 기기 A (기기 A가 아닌 다른 기기)를 동일한 기기를 사용하는 통합). 프로젝트 A가 4개의 명령어를 기기 A가 1분 이내에 기기 A에 명령어 하나만 전송하면 프로젝트 B는 1분 전에 알림을 전송합니다. 그때 두 프로젝트에서 기기 A로 보내는 명령은 애플리케이션이 끝날 때까지 장치 A에 대한 첫 번째 명령으로 시작된 분입니다.
아래 목록에 없는 기기 유형은 기기 인스턴스 수준이 없는 것입니다. 비율 제한.
| 기기 유형 | 기기 인스턴스 비율 제한 |
|---|---|
| 온도 조절기 | 5 QPM 또는 100 QPH |
| 카메라 | 30 QPM 또는 100 QPH |
| DOORBELL | 30 QPM 또는 100 QPH |
오류
이 가이드와 관련하여 다음과 같은 오류 코드가 반환될 수 있습니다.
| 오류 메시지 | RPC | 문제 해결 |
|---|---|---|
| 속도가 제한되었습니다. | RESOURCE_EXHAUSTED |
각 개발자는 호출할 수 있는 횟수를 제한하는 할당량이 있습니다. 할당량보다 많은 호출을 하는 경우 Rate Limited 메시지가 표시됩니다. 이 문제를 해결하려면 할당량이 만료된 후 통화를 다시 제출하세요. |
API 오류 코드 참조에서 API 오류 코드의 전체 목록입니다.