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

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

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

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

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

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

Мониторинг

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

Чтобы посмотреть текущие показатели, перейдите в раздел Показатели сервиса Home API в проекте Google Cloud, связанном с регистрацией вашего приложения в Google Home Developer Console.

Настроить уведомления

Рекомендуем настроить оповещения о достижении определенного порога (например, 80%) выделенной квоты. В Google Cloud есть множество оповещений, которые можно настраивать.

При создании оповещения о квоте используйте следующие показатели в разделе Consumer Quota (Квота пользователя) > Quota (Квота) в редакторе правил.

  • Использование квоты на выделение ресурсов – serviceruntime.googleapis.com/quota/allocation/usage.
  • Лимит квоты – serviceruntime.googleapis.com/quota/limit

Партнерам также следует настроить каналы уведомлений (например, электронную почту) для получения оповещений о квотах.

Дополнительную информацию об оповещениях и уведомлениях, а также о том, как настроить их в Google Cloud, можно найти в следующих ресурсах:

Как запросить увеличение квоты

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

Чтобы посмотреть статистику использования и лимиты, перейдите в раздел Quotas & System Limits (Квоты и системные лимиты) сервиса Home API в проекте Google Cloud, связанном с регистрацией вашего приложения в Developer Console.

Чтобы запросить увеличение, измените определенную квоту. Инструкции приведены в разделе Запрос на изменение квоты документации Google Cloud.