Pacote de testes do Google Home

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

De nuvem para nuvem SDK local do Google Home

O Google Home Test Suite é um aplicativo da Web que permite fazer o teste automático da sua ação de casa inteligente. O Test Suite gera e executa casos de teste automaticamente com base nos dispositivos e características associados à sua conta. Quando você concluir os testes, poderá vê-los ou preencher o formulário de envio para enviá-los ao Google.

Os testes executados pelo Test Suite incluem, entre outros:

É possível iniciar a ferramenta Test Suite clicando no botão abaixo:

Iniciar Test Suite

Autoteste sua ação

A seção a seguir descreve como executar o Test Suite no dispositivo e no projeto de ação de casa inteligente. O Test Suite exige que você faça login para que ele possa inspecionar os dispositivos no Google Home Graph e enviar comandos diretamente ao Google Assistant.

Para testar sua ação por conta própria, siga estas etapas:

  1. No navegador da Web, abra Test Suite.
  2. Faça login no Google usando o botão no canto superior direito.

  3. Configure os detalhes do projeto:

    1. No campo ID do projeto, insira o identificador do projeto para a ação de casa inteligente.
    2. Clique em Próxima.
  4. Defina as Configurações de teste:

    1. Se você certificar a ação de casa inteligente, não altere o valor padrão Relatório de estado/solicitação de tempo limite de sincronização. No entanto, para testes, é possível alterar o valor do tempo limite se o agente demorar mais para informar o estado ao Home Graph.
    2. Ao certificar sua ação de casa inteligente, confira se a opção Testar solicitação de sincronização está ativada. Durante o teste, você precisará adicionar, atualizar ou remover um dispositivo e verificar se a lista de dispositivos mudou no Home Graph. As ações de mudança ocorrem por meio da integração que você está testando. Sua integração em teste precisa sempre ter pelo menos um dispositivo anexado ao usuário do agente.

    3. Se você estiver usando uma característica de Cena, selecione Testar característica de cena.

  5. Execute uma execução de teste e veja os resultados:

    1. Clique em Próxima para começar a executar os testes. A interface mostra os dispositivos e as características que estão sendo testadas.
  6. Veja a página Resultados e envio:

    1. Quando os testes forem concluídos, clique em Next para ver os resultados.

Os resultados incluem o número de testes aprovados e reprovados e uma pontuação final que indica a porcentagem de aprovações.

Teste de validação da vinculação de contas

A vinculação de contas tem um papel importante no ecossistema de casas inteligentes do Google. O teste de validação da vinculação de contas em Test Suite verifica o serviço do OAuth em busca de possíveis problemas.

O teste de validação de vinculação de contas contém testes para validar tokens de acesso e tokens de atualização:

Teste de validação do token de acesso

Os tokens de acesso retornados do endpoint de troca de token são testados para garantir que tenham um formato válido e sejam retornados com um token de atualização válido.

Itens de teste Explicação
Verificar se o token de acesso está no formato JWT A vinculação da Conta do Google não recomenda tokens de acesso do formato JWT. Se um formato JWT for encontrado, o seguinte aviso será exibido: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
Verifique se o token de acesso expirável tem um token de atualização. Um token de atualização precisa ser fornecido quando o token de acesso expira. Este teste falhará se nenhum token de atualização for encontrado.

Teste de validação do token de atualização

Os tokens de atualização são testados para garantir que seu endpoint de troca de tokens os troque corretamente por novos tokens de acesso.

Itens de teste Explicação
Token de atualização com token de atualização inválido, verificando a resposta do parceiro. Seu servidor retornará um erro HTTP 400 Bad Request com {"error": "invalid_grant"} a uma solicitação de token de atualização inválida. Se a resposta não corresponder ao "código de erro ou mensagem", este caso de teste falhará. Acesse tokens de atualização de troca para tokens de acesso para mais informações.
Teste se o token de acesso foi atualizado após a atualização do token. Novos tokens de acesso precisam ser retornados em resposta a solicitações de token de atualização. Se o servidor fornecer o mesmo token de acesso, o caso de teste falhará.
Verifique se o token de acesso não expirado ainda é válido. O prazo de validade do token de acesso é exibido.
Verifique se o token de atualização foi alternado durante a atualização. Verificamos se os tokens de atualização foram alterados após uma solicitação de token de atualização. Se o token de atualização mudar, seu servidor só vai invalidar um antigo token de atualização depois que um novo token de atualização for usado, para evitar que ocorram condições de corrida que possam interromper a vinculação de contas do usuário. O teste falhará se você invalidar o token de atualização antigo antes que o novo seja usado.

Mensagens de erro

A tabela a seguir lista algumas mensagens de erro comuns que podem ser encontradas e a forma sugerida de resolvê-las.

Mensagem de erro Como resolver
A API HomeGraph não foi usada no projeto <_id_> antes ou está desativada Verifique se você ativou a API HomeGraph.
Entidade solicitada não encontrada Verifique se o agentUserId é válido e está vinculado ao seu serviço.
Verifique se você tem a permissão resourcemanager.projects.get no projeto ${your project id} e concedeu todas as permissões na tela de consentimento.
  1. Siga as instruções em Resolver problemas de permissões do IAM para garantir que sua conta tenha as permissões resourcemanager.projects.get do projeto.
  2. Acesse a página Apps com acesso à sua conta para verificar as seguintes permissões para "Pacote de testes de casa inteligente":
    • Informações básicas da conta
      1. Ver o endereço de e-mail principal da sua Conta do Google
      2. Ver suas informações pessoais, inclusive aquelas que você disponibilizou publicamente
    • Acesso adicional
      1. Use seu Assistant: acesso amplo à sua Conta do Google
      2. Inspecionar e controlar os dispositivos de casa inteligente no Home Graph
    Se faltar alguém, remova o acesso primeiro e conceda todas as permissões na tela de consentimento ao fazer login novamente.

Enviar os resultados dos testes

Os resultados da Test Suite precisam ser aprovados em 100% dos testes antes de enviar o formulário de certificação. Se você tiver características que exigem teste manual, ainda vai executar a ferramenta Test Suite e anexar o resultado, mesmo que não tenha sido aprovado como 100%.

Para enviar os resultados do teste e certificar sua ação de casa inteligente, siga estas etapas:

  1. Quando receber os resultados do teste e estiver tudo pronto para certificar sua ação de casa inteligente, clique em Enviar na ferramenta Test Suite.
  2. Clique no botão FAZER O DOWNLOAD DOS RESULTADOS DE TESTE para recuperar os resultados do teste.
  3. Clique em ACESSAR FORMULÁRIO DE ENVIO para enviar os resultados do teste ao Google.
  4. Preencha todos os campos obrigatórios e clique em Enviar.