Google Home는 리소스 할당 및 사용을 제한하고 프로젝트 단위로 적절한 할당량을 적용합니다. 세부적인 정책은 리소스 가용성, 사용자 프로필, 서비스 사용 기록 등의 요인에 따라 상이하며 사전 통보 없이 변경될 수 있습니다.
HomeGraph API 한도
이 섹션에는 Google Home Graph API의 비율 제한이 나와 있습니다. 이러한 한도는 REST 및 RPC API에 모두 적용됩니다.
Google에서는 Cloud-to-cloud 통합별로 쿼리, 동기화, 삭제, Report State, 비동기 요청 동기화 API 호출의 합계에 60초당 6,000개의 기본 한도를 적용합니다.
할당량 상향을 요청하려면 다음 정보를 포함하여 ha-certification@google.com으로 문의하세요.
- 이메일 제목: ReportState API 할당량 증가 요청
- 이메일 내용:
- 프로젝트 ID
- 회사명
- 현재 할당량
- 할당량을 늘리려는 이유
| 할당량 | 한도 | 상향 가능성 |
|---|---|---|
| RequestSync(동기 모드) | agentUserId당 최대 동시 요청 수 1개
|
아니요 |
| RequestSync(비동기 모드) | Cloud-to-cloud 통합당 60초당 요청 6,000개의 기본 한도 | 예 |
| 쿼리 | Cloud-to-cloud 통합당 60초당 요청 6,000개의 기본 한도 | 예 |
| 동기화 | Cloud-to-cloud 통합당 60초당 요청 6,000개의 기본 한도 | 예 |
| 삭제 | Cloud-to-cloud 통합당 60초당 요청 6,000개의 기본 한도 | 예 |
| ReportStateAndNotification | Cloud-to-cloud 통합당 60초당 요청 6,000개의 기본 한도 | 예 |
할당량 문제 디버그
통합에 비율 제한이 적용되는 경우 다음 가이드라인을 사용하여 할당량 문제를 진단하고 해결하세요.
Google에서는 할당량을 초과하는 API 호출의 비율을 제한합니다. 이로 인해 상태 불일치가 발생하여 통합에 부정적인 영향을 미칩니다. 예를 들어 비율 제한으로 인해
ReportStateAndNotification요청이 삭제되면 실제 기기 상태가 동기화되지 않아 Google Home app (GHA)에 오래된 정보가 남게 됩니다.RequestSync에서 오류가 발생하는 기본 API인 경우 서비스가agentUserId당 동시 호출을 두 번 이상 시도하지 않는지 확인하세요.시간이 지남에 따라 트래픽 증가를 검토합니다. 이 증가가 기기 수 증가, 새 기기 유형 출시 또는 기타 예상되는 출시와 일치하는 경우 할당량 증가를 요청합니다. 이 증가가 예상치 못한 경우 통합을 검토하여 예상치 못한 변경으로 인해 Home Graph API로 전송되는 트래픽이 증가하는지 확인합니다.