Google Home Test Suite è un'applicazione web che ti consente di eseguire il self-test dell'azione per la smart home. Test Suite genera ed esegue automaticamente i casi di test in base ai dispositivi e alle caratteristiche associati al tuo account. Al termine dei test, puoi visualizzarne i risultati.
Per utilizzare Test Suite e inviare i risultati dei test a Google per la certificazione, consulta la pagina Testa e condividi le azioni per la smart home per informazioni. Questa versione di Test Suite è specifica per lo sviluppo e la garanzia di qualità.
I test eseguiti dal Test Suite includono, a titolo esemplificativo:
Verifica che Report State e Request Sync siano implementati per i tuoi dispositivi e tratti.
Verifica che l'intent QUERY sia implementato per il tuo dispositivo e che i relativi risultati corrispondano a quelli dello stato del report.
Puoi avviare lo strumento Test Suite facendo clic sul pulsante di seguito:
Eseguire il test autonomo dell'azione
La sezione seguente descrive come eseguire Test Suite sul tuo dispositivo e nel progetto di azioni per la smart home. Test Suite richiede di accedere per poter ispezionare i dispositivi nel tuo Google Home Graph e inviare comandi direttamente a Google Assistant.
Per eseguire il test autonomo dell'azione:
- Nel browser web, apri Test Suite.
Accedi a Google utilizzando il pulsante nell'angolo in alto a destra.
Configura i Dettagli progetto:
- Nel campo ID progetto, inserisci l'identificatore del progetto per l'azione di domotica.
- Fai clic su Avanti.
Configura le Impostazioni di test:
- Se stai certificando l'integrazione di Cloud-to-cloud, lascia invariato il valore predefinito di Timeout sincronizzazione stato report/richiesta. Tuttavia, per i test, puoi modificare il valore del timeout se l'agente impiega più tempo a segnalare lo stato a Home Graph.
Se stai certificando l'integrazione di Cloud-to-cloud, assicurati che l'opzione Testa la sincronizzazione delle richieste sia attivata. Durante il test, ti verrà chiesto di aggiungere, aggiornare o rimuovere un dispositivo e di controllare se l'elenco dei dispositivi è cambiato in Home Graph. Le azioni di modifica vengono eseguite tramite l'integrazione che stai testando. L'integrazione in test deve sempre avere almeno un dispositivo collegato all'utente agente.
Se utilizzi un tratto Scene, seleziona Test Scene trait.
Se esegui la suite di test per i dispositivi Local Home, seleziona Supporta l'SDK della casa locale.
- Seleziona Esecuzione dell'ordine locale o Configurazione senza problemi.
- Fai clic su Supporta query locale se il dispositivo può gestire l'intent QUERY localmente.
Esegui una simulazione e visualizza i risultati:
- Fai clic su Avanti per iniziare a eseguire i test. L'interfaccia mostra i dispositivi e le caratteristiche in fase di test.
Visualizza la pagina Risultati e invio:
- Al termine dei test, fai clic su Avanti per visualizzare i risultati.
I risultati dei test includono il numero di test superati e non superati e un voto 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 controlla 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 token vengono testati per verificare che abbiano un formato valido e che vengano restituiti con un token di aggiornamento valido.
| Elementi di test | Spiegazione |
|---|---|
| Verificare se il token di accesso è in formato JWT | Per il collegamento dell'Account Google non sono consigliati i token di accesso in 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 con scadenza abbia un token di aggiornamento. | Deve essere fornito un token di aggiornamento quando il token di accesso è scaduto. Questo test non andrà a buon fine se non viene trovato alcun token di aggiornamento. |
Test di convalida del token di aggiornamento
I token di aggiornamento vengono testati per assicurarsi che l'endpoint di scambio dei token li scambi correttamente con nuovi token di accesso.
| Elementi di test | Spiegazione |
|---|---|
| Token di aggiornamento con token di aggiornamento non valido, controllo della risposta del partner. | Il server deve restituire un errore HTTP 400 Bad Request con
{"error": "invalid_grant"} a una richiesta di token di aggiornamento non valido.
Se la risposta non corrisponde al "codice o messaggio di errore", questo caso di test non andrà a buon fine. Per ulteriori informazioni, consulta la sezione
scambiare token di aggiornamento con token di accesso. |
| Verifica se il token di accesso è stato aggiornato dopo l'aggiornamento del token. | I nuovi token di accesso devono essere restituiti in risposta alle richieste di token di aggiornamento. Se il server fornisce lo stesso token di accesso, il test case non andrà a buon fine. |
| Verifica che il token di accesso non scaduto sia ancora valido. | Viene visualizzata la data e l'ora di scadenza del token di accesso. |
| Controlla se il token di aggiornamento è stato ruotato durante l'aggiornamento. | Controlliamo 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 vecchio token di aggiornamento 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. Il test non andrà a buon fine se invalidi il vecchio token di aggiornamento prima che venga utilizzato quello nuovo. |
Messaggi di errore
La tabella seguente elenca alcuni messaggi di errore comuni che potresti riscontrare e il modo suggerito per risolverli.
| Messaggio di errore | Come risolvere il problema |
|---|---|
| L'API HomeGraph non è stata utilizzata in precedenza nel progetto <_id_> o è disabilitata | Assicurati di aver attivato l'API HomeGraph. |
| Entità richiesta non trovata | Verifica che il tuo agentUserId sia valido e collegato al servizio. |
Assicurati di disporre dell'autorizzazione Errore durante il recupero dei dati del modulo: errore getModuleData: risposta di errore HTTP per https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Inviare i risultati del test
I risultati di Test Suite devono superare il 100% dei test prima di essere inviati per la certificazione. Se hai elementi che richiedono test manuali, devi comunque eseguire lo strumento Test Suite e allegare il risultato anche se non è stato superato al 100%.
Per inviare i risultati del test e certificare l'integrazione di Cloud-to-cloud:
- Dopo aver ricevuto i risultati del test e aver completato la certificazione dell'integrazione di Cloud-to-cloud, fai clic su Invia nello strumento Test Suite.
- Vai a Google Home Developer Console > Cloud-to-cloud > Certifica.
- Seleziona l'integrazione che vuoi certificare.
- In Documentazione, inserisci il Test Suite ID risultati.
Compila tutti i campi obbligatori, quindi fai clic su Invia.