Conjunto de testes de casa inteligente

O conjunto de testes para casa inteligente é um aplicativo da Web que permite que você faça um autoteste da sua Ação de casa inteligente. O conjunto de testes gera e executa automaticamente casos de teste com base nos dispositivos e características associadas à sua conta. Ao concluir os testes, você pode ver os resultados do teste ou preencher o formulário de envio para enviar os resultados do teste ao Google.

Os testes executados pelo conjunto de testes incluem, mas não estão limitados ao seguinte:

Você pode iniciar a ferramenta do conjunto de testes clicando no botão abaixo:

Iniciar suíte de testes

Autoteste sua ação

A seção a seguir descreve como executar o conjunto de testes em seu dispositivo e projeto de ação de casa inteligente. O conjunto de testes exige que você faça login para que ele possa inspecionar os dispositivos no seu gráfico inicial e enviar comandos diretamente para o Google Assistente.

Para testar sua ação, siga estas etapas:

  1. No navegador da Web, abra o conjunto de testes para casa inteligente .
  2. Faça login no Google usando o botão do canto superior direito.

  3. Configure os detalhes do projeto :

    1. No campo ID do projeto , insira o identificador do projeto para sua ação de casa inteligente.
    2. Clique em Avançar .
  4. Defina as configurações de teste :

    1. Se estiver certificando sua ação de casa inteligente, deixe o valor padrão Report State/Request Sync Timeout inalterado. No entanto, para teste, você pode alterar o valor do tempo limite se seu agente demorar mais para relatar o estado ao gráfico inicial.
    2. Se estiver certificando sua Ação de casa inteligente, certifique-se de que a opção Sincronização de solicitação de teste esteja habilitada - durante o teste, você será solicitado a adicionar, atualizar ou remover um dispositivo e verificar se a lista de dispositivos foi alterada no Gráfico inicial. As ações de mudança ocorrem por meio da integração que você está testando. Sua integração em teste deve sempre ter pelo menos um dispositivo conectado ao usuário agente.

    3. Se você estiver usando uma característica de cena , selecione a característica de cena de teste .

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

    1. Clique em Avançar para iniciar a execução de testes. A interface mostra os dispositivos e características que estão sendo testados.
  6. Veja a página de resultados e envio :

    1. Quando os testes estiverem concluídos, clique em Avançar para visualizar os resultados.

Os resultados do teste incluem o número de testes aprovados e reprovados, e uma pontuação final indicando a porcentagem de aprovações.

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

A vinculação de contas desempenha um papel importante no ecossistema de casa inteligente do Google. O teste de validação de vinculação de contas no Test Suite verifica possíveis problemas no serviço OAuth.

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

Teste de validação do token de acesso

Os tokens de acesso retornados de seu ponto de extremidade de troca de tokens 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
Verifique se o token de acesso é o formato JWT A vinculação de contas do Google não recomenda tokens de acesso no 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 expirado tem um token de atualização. Um token de atualização deve ser fornecido quando o token de acesso expirar. Este teste falhará se nenhum token de atualização for encontrado.

Atualizar teste de validação de token

Os tokens de atualização são testados para garantir que seu endpoint de troca de tokens os troque adequadamente 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 deve retornar um erro HTTP 400 Bad Request com {"error": "invalid_grant"} para uma solicitação de token de atualização inválida. Se a resposta não corresponder ao "código ou mensagem de erro", este caso de teste falhará. Visite tokens de atualização de troca para tokens de acesso para obter mais informações.
Teste se o token de acesso foi atualizado após a atualização do token. Novos tokens de acesso devem ser retornados em resposta a solicitações de token de atualização. Se o seu 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 tempo de expiração do token de acesso será exibido.
Verifique se o token de atualização foi girado durante a atualização. Verificamos se os tokens de atualização são alterados após uma solicitação de token de atualização. Se o token de atualização for alterado, seu servidor só deve invalidar um token de atualização antigo depois que um novo token de atualização for usado, para evitar condições de corrida que possam quebrar a vinculação da conta de um 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 você pode encontrar e a maneira sugerida de resolvê-las.

Mensagem de erro Como resolver
A API HomeGraph não foi usada no projeto <_id_> antes ou está desativada Certifique-se de ter ativado a API HomeGraph .
Entidade solicitada não encontrada Verifique se seu agentUserId é válido e está vinculado ao seu serviço.

Enviar resultados de teste

Os resultados do seu conjunto de testes devem ser aprovados em 100% dos testes antes de enviar seu formulário de certificação . Se você tiver alguma característica que exija teste manual, ainda deverá executar a ferramenta do conjunto de testes e anexar o resultado, mesmo que não tenha sido aprovado em 100%.

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

  1. Depois de receber os resultados do teste e estiver pronto para certificar sua ação de casa inteligente, clique em Enviar na ferramenta do conjunto de testes.
  2. Clique no botão BAIXAR RESULTADOS DO TESTE para recuperar os resultados do teste.
  3. Clique em IR PARA O FORMULÁRIO DE SUBMISSÃO para enviar os resultados do teste ao Google.
  4. Preencha todos os campos obrigatórios e clique em Enviar .