Управление квотами

Для Home API реализована система квот, которая обеспечивает надежность сервиса и помогает разработчикам эффективно управлять объемом трафика. Квоты для Home API действуют на уровне проекта Google Cloud.

Для Home API установлено ограничение в 30 000 запросов в минуту на проект. Это ограничение распространяется на все запросы, отправленные через Home API.

Недостаточно места

Если лимит на количество запросов к API Home превышен, возникает ошибка resourceExhaused HomeException. Последующие запросы будут отклоняться с сообщением "Превышена квота".

Если квота превышена, в приложениях должна быть реализована экспоненциальная отсрочка и уведомления для пользователей о временном ограничении действий.

Мониторинг

Используйте консоль Google Cloud, чтобы отслеживать использование в режиме реального времени и настраивать упреждающие оповещения, когда вы приближаетесь к квоте Home API.

Чтобы посмотреть текущие показатели, перейдите в раздел Показатели сервиса 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.