Pacote de testes do Google Home

Google Home Test Suite is a web application that allows you to self-test your smart home Action. The Test Suite automatically generates and runs test cases based on the devices and traits associated with your account. When you complete the tests, you can view the test results or fill in the submission form to submit the test results to Google.

Os testes executados pelo Test Suite incluem, entre outros, os seguintes:

• Verifica se o Estado do relatório e a Sincronização de solicitações estão implementados para seus dispositivos e características.

• Verifica se a intent QUERY está implementada no seu dispositivo e se os resultados correspondem aos resultados do estado do relatório.

Para iniciar a ferramenta Test Suite, clique 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 inspecionar os dispositivos no Google Home Graph and send commands directly to Google Assistant .

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

1. No navegador da Web, abra Test Suite.

2. Faça login no Google com 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 a ação da casa inteligente.
   2. Clique em Próxima.

4. Defina as configurações de teste:

   1. Se você certificar sua ação de casa inteligente, não altere o valor padrão de Estado do relatório/tempo limite da sincronização de solicitação. No entanto, para teste, é possível alterar o valor de tempo limite se o agente demorar mais para informar o estado para o Home Graph.

   2. Ao certificar sua ação de casa inteligente, verifique se a opção Sync Request Sync está ativada. Durante o teste, você receberá uma solicitação para 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. A 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 da cena.

   4. Se você estiver executando o conjunto de testes para dispositivos de casa local, selecione Compatível com o SDK local do Google Home.

      1. Selecione Fulfillment local ou Configuração integrada.
      2. Clique em Compatível com consulta local se o dispositivo puder tratar a intent QUERY localmente.

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ção.

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

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

O teste de validação da vinculação da conta 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 tokens são testados para garantir que tenham um formato válido e são 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 de Contas do Google não recomenda tokens de acesso ao 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.

Atualizar teste de validação do token

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 ou mensagem de erro", este caso de teste falhará. Acesse tokens de atualização da 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 será exibido.
Verifique se o token de atualização foi alternado 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 mudar, o servidor só poderá invalidar um antigo depois que um novo for usado para evitar disputas que possam interromper a vinculação de contas de usuários. O teste falhará se você invalidar o token de atualização antigo antes que o novo seja usado.

Mensagens de erro

Veja na tabela a seguir 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	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. Erro ao receber dados do módulo: getModuleData erro: resposta de falha HTTP para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Siga as instruções em Resolver problemas de permissões do IAM para verificar se a conta tem as permissões resourcemanager.projects.get do projeto. Acesse a página Apps com acesso à sua conta para verificar as seguintes permissões para "Pacote de testes de casas inteligentes": Informações básicas da conta Ver o endereço de e-mail principal da sua Conta do Google Ver suas informações pessoais, inclusive aquelas que você disponibilizou publicamente Acesso adicional Use seu Assistant: acesso amplo à sua Conta do Google Inspecionar e controlar os dispositivos de casa inteligente no seu gráfico da casa Se você receber um erro de permissão, primeiro remova o acesso e conceda todas as permissões na tela de consentimento quando fizer login novamente.

Enviar resultados do teste

Os resultados de Test Suite precisam passar por 100% dos testes antes de enviar seu formulário de certificação. Se você tiver características que precisam de testes manuais, ainda execute a ferramenta Test Suite e anexe o resultado, mesmo que ele não tenha sido aprovado em 100%.

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

1. Depois de receber os resultados do teste e estar 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 DO TESTE para recuperar os resultados do teste.
3. Clique em IR PARA O FORMULÁRIO DE ENVIO para enviar os resultados do teste ao Google.

4. Preencha todos os campos obrigatórios e clique em Enviar.