Google Home Test Suite è un'applicazione web che ti consente di eseguire l'autodiagnostica dell'Azione per la smart home. Il Test Suite genera ed esegue automaticamente scenari di test in base ai dispositivi e ai tratti associati al tuo account. Al termine dei test, puoi visualizzare i risultati.
Per utilizzare la 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 da Test Suite includono, a titolo esemplificativo, quanto segue:
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 di Report State.
Puoi avviare lo strumento Test Suite facendo clic sul pulsante di seguito:
Esegui un test automatico dell'Azione
La sezione seguente descrive come eseguire Test Suite sul tuo dispositivo e sul progetto di azione per la smart home. Test Suite richiede l'accesso per poter ispezionare i dispositivi nella tua Google Home Graph e inviare comandi direttamente a Google Assistant.
Per eseguire la diagnostica automatica dell'Azione, segui questi passaggi:
- Nel browser web, apri la 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 per la smart home.
- 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 di Report State/Request Sync. Tuttavia, per i test, puoi modificare il valore di timeout se l'agente impiega più tempo per segnalare lo stato a Home Graph.
Se stai certificando l'integrazione di Cloud-to-cloud, assicurati che l'opzione Test Request Sync sia attiva. Durante i test, ti verrà chiesto di aggiungere, aggiornare o rimuovere un dispositivo e di verificare se l'elenco dei dispositivi è cambiato in Home Graph. Le azioni di modifica vengono eseguite tramite l'integrazione che stai testando. L'integrazione in fase di test deve sempre avere almeno un dispositivo collegato all'utente dell'agente.
Se utilizzi un tratto Scene, seleziona Testa il tratto Scene.
Se stai eseguendo la suite di test per i dispositivi per la casa Local Home, seleziona Supporta l'SDK Local Home.
- Seleziona Local Fulfillment (Adempimento locale) o Seamless Setup (Configurazione immediata).
- Fai clic su Supporta query locale se il dispositivo può gestire l'intent QUERY localmente.
Esegui un test e visualizza i risultati:
- Fai clic su Avanti per iniziare a eseguire i test. L'interfaccia mostra i dispositivi e i tratti 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 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 per la smart home di Google. Il test di convalida del collegamento degli 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 dei token vengono testati per garantire che abbiano un formato valido e vengano restituiti con un token di aggiornamento valido.
| Elementi di test | Spiegazione |
|---|---|
| Controlla se il token di accesso è in formato JWT | Il collegamento dell'Account Google non consiglia 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. | Se il token di accesso è scaduto, è necessario fornire un token di aggiornamento. 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 garantire 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 valida.
Se la risposta non corrisponde al "codice di errore o messaggio", questo scenario di test non andrà a buon fine. Per saperne di più, consulta la sezione
Scambia i token di aggiornamento con i 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 tuo server fornisce lo stesso token di accesso, lo scenario di test non andrà a buon fine. |
| Verifica se il token di accesso non scaduto è ancora valido. | Verrà visualizzata la data 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 race condition che potrebbero interrompere il collegamento dell'account di un utente. Il test non andrà a buon fine se annulli 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 visualizzare 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 abilitato l'API HomeGraph. |
| Entità richiesta non trovata | Verifica che il tuo agentUserId sia valido e collegato al tuo 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 |
|
Invia i risultati dei test
I risultati di Test Suite devono superare il 100% dei test prima di essere inviati per la certificazione. Se hai dei tratti che richiedono test manuali, devi comunque eseguire lo strumento Test Suite e allegare il risultato anche se non ha superato il test al 100%.
Per inviare i risultati dei test e certificare l'integrazione di Cloud-to-cloud, segui questi passaggi:
- Dopo aver ricevuto i risultati del test e quando è tutto pronto per certificare l'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 l'ID dei risultati di Test Suite.
Compila tutti i campi obbligatori, quindi fai clic su Invia.