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 do recurso, o perfil de 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

Nesta seção, listamos 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 a cada 60 segundos ao conjunto de chamadas de API de consulta, sincronização, exclusão, Report State e sincronização de solicitações assíncronas, por integração do Cloud-to-cloud.

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

  • Assunto do e-mail: Solicitação para aumentar a cota da API ReportState
  • Conteúdo do e-mail:
    • ID do projeto
    • Nome da sua empresa
    • Cota atual
    • Motivo pelo qual você quer aumentar sua cota
Cota Limite Pode aumentar?
RequestSync (modo síncrono) Máximo de 1 solicitação simultânea por agentUserId. Não
RequestSync (modo assíncrono) Limite padrão de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
Consulta Limite padrão de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
Sincronizar Limite padrão de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
Excluir Limite padrão de 6.000 solicitações a cada 60 segundos por integração do Cloud-to-cloud. Sim
ReportStateAndNotification 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 as 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 tenta fazer mais de uma chamada simultânea por agentUserId.

  3. Analise o crescimento do seu 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, solicite um aumento de cota. Se esse aumento for inesperado, revise sua integração para determinar se uma mudança inesperada está fazendo com que mais tráfego seja enviado à API Home Graph.