Квоты и лимиты «Умного дома»

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

Ограничения API HomeGraph

В этом разделе перечислены ограничения скорости запросов к API Google Home Graph . Эти ограничения применяются как к REST , так и к RPC API.

Google применяет ограничение по умолчанию в 6000 запросов за 60 секунд к совокупности ваших вызовов API для запросов, синхронизации, удаления, Report State и асинхронной синхронизации запросов, для каждой интеграции Cloud-to-cloud .

Для запроса увеличения квоты обратитесь по адресу ha-certification@google.com , предоставив следующую информацию:

  • Тема письма: Запрос на увеличение квоты API ReportState
  • Содержание электронного письма:
    • Идентификатор проекта
    • Название вашей компании
    • Текущая квота
    • Причина, по которой вы хотите увеличить свою квоту
Квота Лимит Может быть увеличен
RequestSync (синхронный режим) Максимум 1 одновременный запрос на agentUserId . Нет
RequestSync (асинхронный режим) По умолчанию установлено ограничение в 6000 запросов за 60 секунд для интеграции между Cloud-to-cloud . Да
Запрос По умолчанию установлено ограничение в 6000 запросов за 60 секунд для интеграции между Cloud-to-cloud . Да
Синхронизация По умолчанию установлено ограничение в 6000 запросов за 60 секунд для интеграции между Cloud-to-cloud . Да
Удалить По умолчанию установлено ограничение в 6000 запросов за 60 секунд для интеграции между Cloud-to-cloud . Да
ReportStateAndNotification По умолчанию установлено ограничение в 6000 запросов за 60 секунд для интеграции между Cloud-to-cloud . Да

Проблемы с квотами отладки

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

  1. Google ограничивает количество вызовов API, превышающих вашу квоту. Это негативно сказывается на интеграции, вызывая несоответствия состояний. Например, если запрос ReportStateAndNotification отклоняется из-за ограничения количества запросов, синхронизация физического состояния устройства не удастся, и Google Home app (GHA) будет содержать устаревшую информацию.

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

  3. Проанализируйте динамику роста трафика за определенный период времени. Если этот рост соответствует увеличению количества устройств, запуску нового типа устройств или другому ожидаемому запуску, запросите увеличение квоты. Если этот рост неожиданный, проверьте интеграцию, чтобы определить, не приводит ли какое-либо неожиданное изменение к увеличению трафика, направляемого в Home Graph API.