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

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

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

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

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

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

  • Тема письма: "Запрос на увеличение квоты ReportState API"
  • Содержание письма:
    • Идентификатор проекта
    • Название компании
    • Текущая квота
    • Причина, по которой вы хотите увеличить квоту.
Квота Ограничение Можно увеличить
RequestSync (синхронный режим) Не более одного параллельного запроса в 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, убедитесь, что ваш сервис не пытается выполнить более одного одновременного вызова на agentUserId.

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