Pacote de testes do Google Home

O Google Home Test Suite é um aplicativo da Web que permite testar sua 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. 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, entre outros:

Para iniciar a ferramenta Test Suite, clique no botão abaixo:

Lançamento Test Suite

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

Para testar sua 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, digite 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 estiver certificar sua ação de casa inteligente, não altere o valor padrão de Estado do relatório/tempo limite da sincronização da solicitação. No entanto, para testes, você poderá mudar o valor do tempo limite se o agente demorar mais para informar o estado ao Home Graph.
    2. Se você estiver fazendo o certificado da ação de casa inteligente, confira se a opção Test Request Sync está ativada. Durante o teste, você vai precisar adicionar, atualizar ou remover um dispositivo e conferir se a lista mudou no Home Graph. As ações de mudança ocorrem na integração que você está testando. Sua integração em teste precisa ter sempre pelo menos um dispositivo anexado ao usuário do agente.

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

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

      1. Selecione Local Fulfillment ou Configuração integrada.
      2. Clique em Supports Local Query se o dispositivo puder processar a intent QUERY localmente.
  5. Execute um Test Run e confira os resultados:

    1. Clique em Próxima para iniciar os testes. A interface mostra os dispositivos e as características que estão sendo testados.
  6. Veja a página Resultados e envios:

    1. Quando os testes forem concluídos, clique em Próxima para ver 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 da vinculação de contas

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

O teste de validação da 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 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 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 expirável tem um token de atualização. Um token de atualização precisa 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 do 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 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 à mensagem ou ao código 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 às 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 precisará invalidar um token antigo somente após o uso de um novo. Isso evita disputas que possam interromper a vinculação de contas 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 abaixo 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: getModuleData error: Resposta de falha de HTTP para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  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 para o projeto.
  2. Acesse a página Apps com acesso à sua conta para verificar as seguintes permissões em "Pacote de testes 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ê 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 você receber um erro de permissão, primeiro remova o acesso e conceda todas as permissões na tela de permissão quando fizer login novamente.

Enviar resultados do teste

Seus resultados de Test Suite precisam passar em 100% dos testes antes de enviar o formulário de certificação. Se você tiver alguma característica que exija testes manuais, ainda será necessário executar a ferramenta Test Suite e anexar o resultado, mesmo que ele não tenha sido aprovado em 100%.

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

  1. Depois de receber os resultados do teste e estiver tudo pronto para certificar a 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.