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