Cotas e limites da casa inteligente

O Google Home limita a alocação e o uso de recursos e aplica cotas apropriadas por projeto. As políticas específicas variam de acordo com a disponibilidade de recursos, o perfil do usuário, o histórico de uso do serviço e outros fatores, e estão sujeitas a alterações sem aviso prévio.

Limites da API HomeGraph

Esta seção lista os limites de taxa da API Google Home Graph. Esses limites se aplicam às APIs REST e RPC.

O Google aplica o limite padrão de 6.000 solicitações por 60 segundos ao agregado das suas chamadas de API de consulta, sincronização, exclusão, Report State e sincronização de solicitações assíncronas, por integração de Cloud-to-cloud.

Para solicitar um aumento de cota, entre em contato com ha-certification@google.com e envie as seguintes informações:

  • Assunto do e-mail: Solicitação de aumento da cota da API ReportState
  • Conteúdo do e-mail:
    • ID do projeto
    • Nome da sua empresa
    • Cota atual
    • Motivo para aumentar sua cota
Cota Limite Pode aumentar?
RequestSync (modo síncrono) Máximo de uma solicitação simultânea por agentUserId. Não
RequestSync (modo assíncrono) O limite padrão é de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
Consulta O limite padrão é de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
Sincronização O limite padrão é de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
Excluir O limite padrão é de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
ReportStateAndNotification O limite padrão é de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim

Depurar problemas de cota

Se a integração tiver limitação de taxa, use as diretrizes a seguir para diagnosticar e resolver problemas de cota:

  1. O Google vai limitar a taxa de chamadas de API que excederem sua cota. Isso afeta negativamente sua integração, causando incompatibilidades de estado. Por exemplo, se uma solicitação ReportStateAndNotification for descartada devido à limitação de taxa, o status do dispositivo físico não será sincronizado, deixando o Google Home app (GHA) com informações desatualizadas.

  2. Se RequestSync for a API principal com erros, verifique se o serviço não está tentando fazer mais de uma chamada simultânea por agentUserId.

  3. Analise o crescimento do tráfego ao longo do tempo. Se esse crescimento for consistente com um aumento no número de dispositivos, o lançamento de um novo tipo de dispositivo ou algum outro lançamento esperado, peça um aumento na cota. Se esse aumento for inesperado, analise sua integração para determinar se uma mudança inesperada está causando o envio de mais tráfego para a API Home Graph.