Test Suite Google Home

Cloud-to-cloud    SDK Local Home

Google Home Test Suite è un'applicazione web che ti consente di testare autonomamente l'azione per la tua smart home. Test Suite genera ed esegue automaticamente scenari di test in base ai dispositivi e ai trait associati al tuo account. Una volta completati i test, puoi visualizzarne i risultati o compilare il modulo di invio per inviarli a Google.

I test eseguiti da Test Suite includono, a titolo esemplificativo, quanto segue:

  • Controlla che Stato del report e Richiedi sincronizzazione siano implementati per i tuoi dispositivi e i tuoi trait.

  • Verifica che l'intent QUERY sia implementato per il dispositivo e che i relativi risultati corrispondano a quelli dello stato del report.

Puoi avviare lo strumento Test Suite facendo clic sul pulsante qui sotto:

Lancio Test Suite

Esegui l'autotest dell'azione

La seguente sezione descrive come eseguire Test Suite sul tuo dispositivo e sul progetto di azione per la smart home. Il Test Suite richiede l'accesso in modo che possa ispezionare i dispositivi nel tuo Google Home Graph e inviare comandi direttamente a Google Assistant.

Per eseguire l'autotest dell'Azione, procedi nel seguente modo:

  1. Nel browser web, apri Test Suite.
  2. Accedi a Google usando il pulsante nell'angolo in alto a destra.

  3. Configura i dettagli del progetto:

    1. Nel campo ID progetto, inserisci l'identificatore del progetto per l'Azione per la smart home.
    2. Fai clic su Avanti.
  4. Configura le impostazioni di test:

    1. Se stai certificando l'Azione per la smart home, lascia invariato il valore predefinito Stato report/Timeout sincronizzazione richiesta. Tuttavia, per i test, puoi modificare il valore di timeout se l'agente impiega più tempo per segnalare lo stato a Home Graph.
    2. Se stai certificando l'azione per la smart home, assicurati che l'opzione Testa richiesta di sincronizzazione sia attivata: durante il test, ti verrà chiesto di aggiungere, aggiornare o rimuovere un dispositivo e controllare se l'elenco dei dispositivi è cambiato in Home Graph. Le azioni di modifica avvengono tramite l'integrazione che stai testando. L'integrazione in fase di test deve avere sempre almeno un dispositivo collegato all'utente agente.

    3. Se utilizzi un trait Scene, seleziona Testa il trait Scena.

    4. Se esegui la suite di test per i dispositivi per la casa locale, seleziona Supporta l'SDK Local Home.

      1. Seleziona Distribuzione locale o Configurazione immediata.
      2. Fai clic su Supporta query locale se il dispositivo può gestire l'intent QUERY localmente.
  5. Esegui un'esecuzione di test e visualizza i risultati:

    1. Fai clic su Avanti per iniziare a eseguire i test. L'interfaccia mostra i dispositivi e le caratteristiche che vengono testati.
  6. Visualizza la pagina Risultati e invio:

    1. Una volta completati i test, fai clic su Avanti per visualizzare i risultati.

I risultati del test includono il numero di test superati e non superati e un punteggio finale che indica la percentuale di test superati.

Test di convalida del collegamento dell'account

Il collegamento degli account svolge un ruolo importante nell'ecosistema della smart home di Google. Il test di convalida del collegamento dell'account in Test Suite verifica la presenza di potenziali problemi nel servizio OAuth.

Il test di convalida del collegamento dell'account contiene test per convalidare i token di accesso e i token di aggiornamento:

Test di convalida del token di accesso

I token di accesso restituiti dall'endpoint di scambio di token vengono testati per garantire che abbiano un formato valido e vengano restituiti con un token di aggiornamento valido.

Elementi di test Spiegazione
Verifica se il token di accesso è in formato JWT Il collegamento dell'Account Google sconsiglia i token di accesso al formato JWT. Se viene trovato un formato JWT, viene visualizzato il seguente avviso: 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.
Verifica che il token di accesso espandibile abbia un token di aggiornamento. È necessario fornire un token di aggiornamento quando il token di accesso è idoneo. Questo test avrà esito negativo se non viene trovato alcun token di aggiornamento.

Aggiorna test di convalida del token

I token di aggiornamento vengono testati per garantire che l'endpoint di scambio di token li scambi correttamente con nuovi token di accesso.

Elementi di test Spiegazione
Token di aggiornamento con token di aggiornamento non valido; verifica della risposta del partner. Il server dovrebbe restituire un errore HTTP 400 Bad Request con {"error": "invalid_grant"} a una richiesta di token di aggiornamento non valida. Se la risposta non corrisponde al "codice o messaggio di errore", questo scenario di test avrà esito negativo. Per ulteriori informazioni, visita la pagina relativa alla scambio di token di aggiornamento per i token di accesso.
Verifica se il token di accesso è stato aggiornato dopo l'aggiornamento dei token. I nuovi token di accesso devono essere restituiti in risposta alle richieste di token di aggiornamento. Se il tuo server fornisce lo stesso token di accesso, lo scenario di test avrà esito negativo.
Controlla se il token di accesso non scaduto è ancora valido. Verrà visualizzata la data di scadenza del token di accesso.
Verifica se il token di aggiornamento è stato ruotato durante l'aggiornamento. Verifichiamo se i token di aggiornamento vengono modificati dopo una richiesta di token di aggiornamento. Se il token di aggiornamento cambia, il server deve invalidare un token di aggiornamento precedente solo dopo che è stato utilizzato un nuovo token di aggiornamento, per evitare condizioni di gara che potrebbero interrompere il collegamento dell'account di un utente. Se il token di aggiornamento precedente viene invalidato prima di utilizzare quello nuovo, il test avrà esito negativo.

Messaggi di errore

La seguente tabella elenca alcuni messaggi di errore comuni che potresti visualizzare e il modo suggerito per risolverli.

Messaggio di errore Come risolvere
L'API HomeGraph non è stata utilizzata in precedenza nel progetto <_id_> o è disabilitata Assicurati di aver abilitato l'API Home Graph.
Entità richiesta non trovata Verifica che agentUserId sia valido e che sia collegato al tuo servizio.

Assicurati di avere l'autorizzazione resourcemanager.projects.get sul progetto ${your project id} e di aver concesso tutte le autorizzazioni nella schermata del consenso.

Errore durante il recupero dei dati del modulo: errore getModuleData: risposta all'errore HTTP per https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. Segui le istruzioni in Risolvere i problemi relativi alle autorizzazioni IAM per assicurarti che il tuo account disponga delle autorizzazioni resourcemanager.projects.get per il progetto.
  2. Vai alla pagina App con accesso al tuo account per controllare le seguenti autorizzazioni per "Suite di test per la smart home":
    • Informazioni di base sull'account
      1. Visualizzare l'indirizzo email principale del tuo Account Google
      2. Visualizza le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili
    • Accesso aggiuntivo
      1. Usa il tuo Assistant: accesso ampio al tuo Account Google
      2. Ispeziona e controlla i dispositivi per la smart home in Home Graph
    Se visualizzi un errore di autorizzazione, rimuovi prima l'accesso e concedi tutte le autorizzazioni nella schermata per il consenso quando esegui di nuovo l'accesso.

Inviare i risultati del test

I risultati di Test Suite devono superare il 100% dei test prima di inviare il modulo di certificazione. Se hai trait che richiedono un test manuale, devi comunque eseguire lo strumento Test Suite e allegare il risultato anche se non è stato superato al 100%.

Per inviare i risultati dei test e certificare l'Azione per la smart home, segui questi passaggi:

  1. Dopo aver ricevuto i risultati del test e quando tutto è pronto per certificare l'Azione per la smart home, fai clic su Invia nello strumento Test Suite.
  2. Fai clic sul pulsante SCARICA RISULTATI DEL TEST per recuperare i risultati del test.
  3. Fai clic su VAI AL MODULO DI INVIO per inviare i risultati del test a Google.
  4. Compila tutti i campi obbligatori, poi fai clic su Invia.