A quota system has been implemented for the Home APIs to ensure service reliability and help developers effectively manage traffic volume. Quotas in the Home APIs are at a Google Cloud project-level.
The rate limit for the Home APIs is 30,000 QPM (queries per minute) per project. This limit encompasses all queries sent through the Home APIs.
Quota exceeded
When the Home APIs rate limit is exceeded, a
resourceExhaused
HomeError is thrown. Subsequent requests will be rejected
immediately with a "Quota exceeded" message.
In the event that quota is exceeded, apps should feature an exponential backoff and notify users if actions are temporarily restricted.
Monitoring
Use the Google Cloud Console to monitor usage in real-time and configure proactive alerts for when you get close to a Home APIs quota.
To view current metrics, go to the Metrics section of the Home API service in the Google Cloud project associated with your app's registration in Google Home Developer Console.
Set up alerts
We recommend that partners set up alerts for passing a threshold (such as 80%) of your allocated quota. Alert support in Google Cloud is very extensive and highly configurable.
When creating an alert for quota, you'll want to use the following metrics under Consumer Quota > Quota in the policy builder.
- Allocation quota usage — serviceruntime.googleapis.com/quota/allocation/usage
- Quota limit — serviceruntime.googleapis.com/quota/limit
Partners should also set up notifications channels (such as email) for receiving quota alerts.
See the following resources to learn more about alerting and notifications, and how to configure them in Google Cloud:
Request a quota increase
If your app's has legitimate traffic that requires higher limits than the default rate limit, you can request an increase.
To view usage and limits, go to the Quotas & System Limits section of the Home API service in the Google Cloud project associated with your app's registration in Developer Console.
To request an increase, edit a specific quota. See Request a quota adjustment in the Google Cloud documentation for instructions.