Test Suite Google Home

Cloud-to-cloud    SDK Home locale

Google Home Test Suite è un'applicazione web che ti consente di testare autonomamente la tua azione per la casa intelligente. Test Suite genera ed esegue automaticamente scenari di test in base ai dispositivi e alle caratteristiche associati al tuo account. Una volta completati i test, potrai visualizzarne i risultati.

Per utilizzare Test Suite e inviare i risultati dei test a Google per la certificazione, consulta la pagina Test e condivisione delle azioni per la casa intelligente per informazioni. Questa versione di Test Suite è specificatamente destinata allo sviluppo e al controllo qualità.

I test eseguiti da Test Suite includono, ma non sono limitati a, quanto segue:

  • Verifica che Report State e Request Sync siano implementati per i tuoi dispositivi e le tue caratteristiche.

  • Verifica che l'intento QUERY sia implementato per il tuo dispositivo e che i suoi risultati corrispondano ai risultati dello stato del report.

Puoi avviare lo strumento Test Suite facendo clic sul pulsante di seguito:

Avvia Test Suite

Autoverifica la tua azione

La sezione seguente descrive come eseguire Test Suite sul tuo dispositivo e sul progetto Azione per la casa intelligente. Test Suite richiede l'accesso per poter ispezionare i dispositivi nel tuo Google Home Graph e inviare comandi direttamente a Google Assistant.

Per eseguire l'autotest dell'azione:

  1. Nel browser web, apri Test Suite.

  2. Accedi a Google utilizzando il pulsante nell'angolo in alto a destra.

  3. Configura i Dettagli progetto:

    1. Nel campo ID progetto, inserisci l'identificativo del progetto per la tua azione per la casa intelligente.
    2. Fai clic su Avanti.

  4. Configura le impostazioni di test:

    1. Se certifichi l'integrazione di Cloud-to-cloud, lascia invariato il valore predefinito di Report State/Request Sync Timeout. Tuttavia, per i test, puoi modificare il valore di timeout se l'agente impiega più tempo per comunicare lo stato a Home Graph.

    2. Se certifichi l'integrazione di Cloud-to-cloud, assicurati che l'opzione Sincronizzazione richiesta di test sia attivata. Durante il test, ti verrà chiesto di aggiungere, aggiornare o rimuovere un dispositivo e di verificare se l'elenco dei dispositivi è cambiato in Home Graph. Le modifiche vengono apportate tramite l'integrazione che stai testando. L'integrazione in fase di test deve sempre avere almeno un dispositivo collegato all'utente agente.

    3. Se utilizzi un tratto Scene, seleziona Tratto Scena di test.

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

      1. Seleziona Evasione locale o Configurazione semplice.
      2. Fai clic su Supporta query locale se il dispositivo può gestire l'intent QUERY localmente.

  5. Esegui un Test Run e visualizza i risultati:

    1. Fai clic su Avanti per iniziare a eseguire i test. L'interfaccia mostra i dispositivi e le caratteristiche in fase di test.

  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 Google. Il test di convalida del collegamento degli account in Test Suite controlla il tuo servizio OAuth per potenziali problemi.

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 assicurarsi che abbiano un formato valido e vengano restituiti con un token di aggiornamento valido.

Elementi di prova 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 scadibile abbia un token di aggiornamento. Un token di aggiornamento deve essere fornito 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 prova 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, visita Scambia 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, lo scenario di test non andrà a buon fine.
Verifica che il token di accesso non scaduto sia 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 dovrebbe invalidare un vecchio token di aggiornamento solo dopo che ne è stato utilizzato uno nuovo, per evitare condizioni di competizione che potrebbero interrompere il collegamento dell'account di un utente. Il test fallirà se si invalida il vecchio token di aggiornamento prima di utilizzare quello nuovo.

Messaggi di errore

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

Messaggio di errore Come risolvere il problema
L'API HomeGraph non è stata utilizzata nel progetto <_id_> in precedenza oppure è 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 resourcemanager.projects.get per il progetto ${your project id} e di aver concesso tutte le autorizzazioni nella schermata del consenso.

Errore durante l'ottenimento dei dati del modulo: errore getModuleData: risposta di errore HTTP per https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. Segui le istruzioni riportate in Risoluzione dei 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 verificare le seguenti autorizzazioni per "Suite di test per la casa intelligente":
    • Informazioni di base sull'account
      1. Visualizzare l'indirizzo email principale del tuo Account Google
      2. Visualizzare le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili
    • Accesso aggiuntivo
      1. Utilizza Assistant: accesso esteso al tuo Account Google
      2. Analizzare e controllare i dispositivi per la smart home in Home Graph
    Se ricevi un errore di autorizzazione, rimuovi prima l'accesso e concedi tutte le autorizzazioni nella schermata del consenso quando accedi di nuovo.

Invia i risultati del test

I risultati di Test Suite devono superare il 100% dei test prima di poter essere inviati per la certificazione. Se hai caratteristiche 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 con Cloud-to-cloud, segui questi passaggi:

  1. Dopo aver ricevuto i risultati del test e quando sei pronto a certificare la tua integrazione Cloud-to-cloud, fai clic su Invia nello strumento Test Suite.
  2. Vai a Google Home Developer Console > Cloud-to-cloud > Certifica.
  3. Seleziona l'integrazione che desideri certificare.
  4. In Documentazione, inserisci l'ID risultati Test Suite.

  5. Compila tutti i campi obbligatori, quindi fai clic su Invia.