Для обеспечения надежности сервиса и эффективного управления объемом трафика в API Home внедрена система квот. Квоты в API Home устанавливаются на уровне проекта Google Cloud .
Ограничение на количество запросов к API Home составляет 30 000 запросов в минуту на проект. Это ограничение распространяется на все запросы, отправляемые через API Home.
Квота превышена
При превышении лимита запросов к API Home генерируется ошибка resourceExhaused HomeError . Последующие запросы будут немедленно отклонены с сообщением "Quota exceeded".
В случае превышения квоты приложения должны иметь механизм экспоненциальной задержки и уведомлять пользователей о временном ограничении действий.
Мониторинг
Используйте консоль Google Cloud для мониторинга использования в режиме реального времени и настройки упреждающих оповещений о приближении к квоте на использование API Home.
Чтобы просмотреть текущие метрики, перейдите в раздел «Метрики» сервиса Home API в проекте Google Cloud , связанном с регистрацией вашего приложения в Google Home Developer Console .
Настройте оповещения
Мы рекомендуем партнерам настроить оповещения о превышении порогового значения (например, 80%) выделенной квоты. Поддержка оповещений в Google Cloud очень обширна и легко настраивается.
При создании оповещения о превышении квоты в конструкторе политик следует использовать следующие метрики в разделе «Квота для потребителей > Квота» .
- Использование выделенной квоты — serviceruntime.googleapis.com/quota/allocation/usage
- Ограничение квоты — serviceruntime.googleapis.com/quota/limit
Партнерам также следует настроить каналы уведомлений (например, электронную почту) для получения оповещений о превышении квоты.
Для получения дополнительной информации об оповещениях и уведомлениях, а также о том, как их настроить в Google Cloud , ознакомьтесь со следующими ресурсами:
- Создайте политики оповещения на основе пороговых значений метрик.
- Создание и управление каналами уведомлений
Запросить увеличение квоты
Если ваше приложение обрабатывает легитимный трафик, требующий более высоких лимитов, чем установленный по умолчанию, вы можете запросить их увеличение.
Чтобы просмотреть информацию об использовании и ограничениях, перейдите в раздел «Квоты и системные ограничения» сервиса Home API в проекте Google Cloud , связанном с регистрацией вашего приложения в Developer Console .
Чтобы запросить увеличение квоты, отредактируйте конкретную квоту. Инструкции см. в разделе «Запрос на изменение квоты» в документации Google Cloud .