Pacote de testes do Google Home

De nuvem para nuvem    SDK do Local Home

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

Os testes executados pelo Test Suite incluem, mas não são são limitados a:

.

Clique no botão para iniciar a ferramenta Test Suite abaixo:

Iniciar Test Suite

Testar uma ação por conta própria

A seção a seguir descreve como executar o Test Suite em seu dispositivo e projeto de ação de casa inteligente. O Test Suite exige que você faça login para inspecionar os dispositivos na sua 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 Ação de casa inteligente.
    2. Clique em Próxima.
  4. Defina as configurações de teste:

    1. Ao certificar sua ação de casa inteligente, mantenha o padrão O valor de Estado do relatório/tempo limite de sincronização da solicitação não foi alterado. No entanto, para teste, será possível alterar o valor de tempo limite se o agente demorar mais para informar o estado para o Home Graph.
    2. Para certificar sua ação de casa inteligente, confira se a Sincronização de solicitação de teste estiver ativada. Durante o teste, será solicitado que você adicione, atualizar ou remover um dispositivo e verificar se a lista de dispositivos mudou em Gráfico de Início. As ações de mudança ocorrem pela integração que você está testando. A integração em teste precisa ter pelo menos um dispositivo associado ao usuário do agente.

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

    4. Se você estiver executando o pacote de testes para dispositivos do Local Home, selecione Oferece suporte ao 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 processar a intent QUERY localmente.
  5. Faça uma execução de teste e confira os resultados:

    1. Clique em Próxima para começar a executar os testes. A interface mostra os dispositivos e características que estão sendo testadas.
  6. Acesse 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 um resultado que indica a porcentagem de passes.

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

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

O teste de validação de vinculação de contas tem testes para validar tokens de acesso. e atualizar tokens:

Teste de validação do token de acesso

Os tokens de acesso retornados do seu endpoint de troca de tokens são testados para garantir elas têm um formato válido e são retornadas 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, e 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 com expiração 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.

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

Os tokens de atualização são testados para garantir que o endpoint de troca de tokens está correto e as troca 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 Solicitação inválida 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", esse caso de teste vai falhar. Visite troque 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 atualização de token. Se 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 prazo de validade 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, seu servidor só deverá invalidar uma atualização token após o uso de um novo token de atualização, para evitar disputas isso pode interromper a vinculação da conta de um usuário. O teste vai falhar se você invalidar o token de atualização antigo antes de usar o novo.

Mensagens de erro

A tabela a seguir lista algumas mensagens de erro comuns que você pode encontrar e as maneira sugerida de resolvê-los.

Mensagem de erro Como resolver
A API HomeGraph não foi usada no projeto <_id_> antes ou está desativado Verifique se você ativou a API HomeGraph.
Entidade solicitada não encontrada Verifique se o agentUserId é válido e está vinculado à sua serviço.

Verifique se você tem a permissão resourcemanager.projects.get no projeto ${your project id} e concederam todos os permissões na tela de consentimento.

Erro ao receber dados do módulo: erro getModuleData: resposta de falha de HTTP para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. Siga as instruções em Solução de problemas permissões do IAM para garantir que sua conta tenha resourcemanager.projects.get para o projeto.
  2. Acesse a página Apps com acesso à sua conta para verificar seguintes permissões em "Pacote de teste para 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, incluindo aquelas que você disponibilizado publicamente
    • Acesso adicional
      1. Use o Assistant: acesso amplo à sua Conta do Google
      2. Inspecionar e controlar os dispositivos de casa inteligente da sua casa Gráfico
    . Se você receber um erro de permissão, remova o acesso primeiro e conceda todos os permissões na tela de permissão ao fazer login novamente.

Enviar os resultados do teste

Seus resultados de Test Suite precisam ser aprovados em 100% dos testes antes enviando seu formulário de certificação. Se você tem alguma característica que exija teste manual, execute a ferramenta Test Suite e anexar o resultado mesmo que não tenha alcançado 100%.

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

  1. Depois de receber os resultados do teste, e você estiver pronto para certificar seus aplicativos home, clique em Submit 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.