서비스 안정성을 보장하고 개발자가 트래픽 양을 효과적으로 관리할 수 있도록 홈 API에 할당량 시스템이 구현되었습니다. Home API의 할당량은 Google Cloud 프로젝트 수준입니다.
Home API의 비율 제한은 프로젝트당 30,000QPM (분당 쿼리 수)입니다. 이 한도에는 Home API를 통해 전송된 모든 쿼리가 포함됩니다.
할당량 초과
Home API 비율 제한을 초과하면 resourceExhaused
HomeError이 발생합니다. 이후 요청은 '할당량 초과' 메시지와 함께 즉시 거부됩니다.
할당량을 초과하는 경우 앱은 지수 백오프를 제공해야 하며 작업이 일시적으로 제한되면 사용자에게 알려야 합니다.
모니터링
Google Cloud 콘솔을 사용하여 실시간으로 사용량을 모니터링하고 Home API 할당량에 근접할 때 사전 알림을 구성하세요.
현재 측정항목을 보려면 Google Home Developer Console에서 앱 등록과 연결된 Google Cloud 프로젝트의 홈 API 서비스의 측정항목 섹션으로 이동합니다.
알림 설정
파트너는 할당된 할당량의 기준점 (예: 80%)을 초과할 때 알림을 받도록 설정하는 것이 좋습니다. Google Cloud의 알림 지원은 매우 광범위하며 구성 가능성이 높습니다.
할당량에 대한 알림을 만들 때는 정책 빌더의 소비자 할당량 > 할당량에서 다음 측정항목을 사용해야 합니다.
- 배정 할당량 사용량 - serviceruntime.googleapis.com/quota/allocation/usage
- 할당량 한도 - serviceruntime.googleapis.com/quota/limit
파트너는 할당량 알림을 수신할 알림 채널 (예: 이메일)도 설정해야 합니다.
알림 및 알림과 Google Cloud에서 이를 구성하는 방법에 대해 자세히 알아보려면 다음 리소스를 참고하세요.
할당량 상향 조정 요청
앱에 기본 비율 제한보다 높은 제한이 필요한 합법적인 트래픽이 있는 경우 상향 조정을 요청할 수 있습니다.
사용량과 한도를 확인하려면 Developer Console에서 앱 등록과 연결된 Google Cloud 프로젝트의 Home API 서비스의 할당량 및 시스템 한도 섹션으로 이동하세요.
상향을 요청하려면 특정 할당량을 수정하세요. 자세한 내용은 Google Cloud 문서의 할당량 조정 요청을 참고하세요.