Квоты и ограничения для умного дома

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

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

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

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

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

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

Как устранять проблемы с квотами

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

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

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

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