Pacote de testes do Google Home

De nuvem para nuvem    SDK Local Home

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

Os testes executados pelo Test Suite incluem, entre outros:

• Verifica se o Estado do relatório e a Sincronização da solicitação foram implementados nos seus dispositivos e características.

• Verifica se a intent QUERY foi implementada no 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

Testar uma ação por conta própria

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 dispositivos no Google Home Graph e enviar comandos diretamente para Google Assistant.

Para fazer o autoteste da ação, siga estas etapas:

1. No navegador da Web, abra o Test Suite.

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 da ação de casa inteligente.
   2. Clique em Próxima.

4. Defina as configurações do teste:

   1. Ao certificar sua ação de casa inteligente, não altere o valor padrão de Estado do relatório/Tempo limite de sincronização da solicitação. No entanto, para testes, é possível mudar o valor de tempo limite se o agente levar mais tempo para informar o estado ao Home Graph.

   2. Para certificar sua ação de casa inteligente, confira se a opção Testar a sincronização de solicitação está ativada. Durante o teste, você vai 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 pela integração que você está testando. A integração em teste sempre precisa ter pelo menos um dispositivo anexado ao usuário agente.

   3. Se você estiver usando uma característica Scene, selecione Testar a característica da cena.

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

      1. Selecione Fulfillment local ou Configuração integrada.
      2. Clique em Suporte a consulta local se o dispositivo puder processar a intent QUERY localmente.

5. Faça um Test Run e confira os resultados:

   1. Clique em Próxima para começar a executar testes. A interface mostra os dispositivos e as características que estão sendo testados.

6. Veja a página Resultados e envio:

   1. Quando os testes forem concluídos, clique em Próxima para ver os resultados.

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

Teste de validação da 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 da vinculação de contas em Test Suite verifica se há possíveis problemas no serviço do OAuth.

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 seu 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 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 precisará ser fornecido quando o token de acesso for expirável. O 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 o endpoint de troca de token os troque corretamente por novos tokens de acesso.

Itens de teste	Explicação
Token de atualização com token inválido, verificando a resposta do parceiro.	Seu servidor deve retornar o erro HTTP 400 Solicitação inválida com {"error": "invalid_grant"} para uma solicitação de token de atualização inválido. Se a resposta não corresponder ao "código ou à mensagem de erro", o caso de teste vai falhar. Acesse trocar tokens de atualização por 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 vai 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 rotacionado 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ó vai invalidar um token de atualização antigo depois que o novo for usado, para evitar disputas que possam interromper 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ê-los.

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 serviço.
Verifique se você tem a permissão resourcemanager.projects.get no projeto ${your project id} e se concedeu todas as permissões na tela de consentimento. Erro ao receber dados do módulo: erro getModuleData: 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 para o projeto. Acesse a página Apps com acesso à sua conta para verificar as seguintes permissões de "Pacote de teste para casa inteligente": 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 Assistant: amplo acesso à sua Conta do Google Inspecionar e controlar os dispositivos de casa inteligente no Home Graph Se você receber um erro de permissão, remova o acesso primeiro e conceda todas as permissões na tela de consentimento quando fizer login novamente.

Enviar os resultados do teste

Os resultados do Test Suite precisam ser aprovados em 100% dos testes antes de enviar o formulário de certificação. Se você tiver alguma característica que exija teste manual, ainda precisará executar 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 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.
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.