Test Suite Google Home

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Cloud-to-cloud    SDK Home Home

La pagina Google Home Test Suite is a web application that allows you to self-test your smart home Action. The Test Suite automatically generates and runs test cases based on the devices and traits associated with your account. When you complete the tests, you can view the test results or fill in the submission form to submit the test results to Google.

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

  • Verifica che le opzioni Stato del report e Sincronizza richiesta siano implementate per dispositivi e caratteristiche.

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

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

Lancia Test Suite

Autoverifica dell'azione

La sezione seguente descrive come eseguire il comando Test Suite sul tuo progetto di azione per la smart home e il tuo dispositivo. La pagina Test Suite richiede l'accesso per poter controllare i dispositivi nel tuo Google Home Graph and send commands directly to Google Assistant .

Per eseguire l'autoverifica 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 del progetto:

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

    1. Se stai certificando l'azione della tua smart home, lascia invariato il valore predefinito Stato rapporto/Timeout sincronizzazione richieste. Tuttavia, per i test, puoi modificare il valore di timeout se l'agente ha bisogno di più tempo per segnalare lo stato al grafico Home.
    2. Se stai certificando l'azione della tua smart home, assicurati che l'opzione Test Request Sync sia attiva; durante la verifica 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 vengono eseguite tramite l'integrazione che stai testando. L'integrazione in fase di test deve avere sempre almeno un dispositivo collegato all'utente dell'agente.

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

    4. Se stai eseguendo la suite di test per dispositivi locali per la casa, seleziona Supporta l'SDK Local Home.

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

    1. Fai clic su Avanti per avviare l'esecuzione dei test. L'interfaccia mostra i dispositivi e le caratteristiche sottoposti a test.
  6. Visualizza la pagina Risultati e invio:

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

I risultati includono il numero di test superati e non superati, nonché un punteggio finale che indica la percentuale di passaggi superati.

Test di convalida del collegamento dell'account

Il collegamento dell'account svolge un ruolo importante nell'ecosistema della smart home di Google. Il test di convalida del collegamento dell'account in Test Suite verifica il tuo servizio OAuth per individuare 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 di token vengono testati per verificare che abbiano un formato valido e vengano restituiti con un token di aggiornamento valido.

Elementi del test Spiegazione
Verificare se il token di accesso è in formato JWT Il collegamento di Account Google non consiglia 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.
Controlla che il token di accesso espirato abbia un token di aggiornamento. È necessario fornire un token di aggiornamento quando è valido. Questo test non andrà a buon fine 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 lo scambi correttamente con nuovi token di accesso.

Elementi del test Spiegazione
Token di aggiornamento con token di aggiornamento non valido. Controllo della risposta del partner. Il tuo server dovrebbe restituire un errore HTTP 400 Bad Request con {"error": "invalid_grant"} a una richiesta di aggiornamento del token non valida. Se la risposta non corrisponde al "codice o messaggio di errore", questo scenario di test non andrà a buon fine. Per ulteriori informazioni, visita la pagina relativa allo aggiornamento dei token di aggiornamento per 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 aggiornamento dei token. 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.
Verifica se il token di aggiornamento è stato ruotato durante l'aggiornamento. Controlliamo se i token di aggiornamento vengono modificati dopo una richiesta di aggiornamento del token. Se il token di aggiornamento cambia, il server deve invalidare un token di aggiornamento precedente solo dopo aver utilizzato un nuovo token di aggiornamento, per evitare condizioni di corsa 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 di utilizzare quello nuovo.

Messaggi di errore

Nella tabella che segue sono riportati alcuni messaggi di errore comuni che potresti visualizzare e il modo consigliato di risolverli.

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

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

Errore durante il recupero dei dati del modulo: getGetData error: Http error response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. Segui le istruzioni sulla 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 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. Visualizzare le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili
    • Accesso aggiuntivo
      1. Utilizza il tuo Assistant: ampio accesso al tuo Account Google
      2. Ispeziona e controlla i dispositivi per la smart home in Home Graph
    Se ricevi un errore relativo alle autorizzazioni, rimuovi prima l'accesso e concedi tutte le autorizzazioni nella schermata per il consenso quando accedi di nuovo.

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 caratteristiche che richiedono il 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 la tua azione per la smart home, procedi nel seguente modo:

  1. Quando ricevi i risultati del test e vuoi certificare l'azione della tua smart home, fai clic su Invia nello strumento Test Suite.
  2. Fai clic sul pulsante SCARICA I RISULTATI TEST per recuperare i risultati del tuo test.
  3. Fai clic su Vai al modulo di presentazione per inviare i risultati del test a Google.
  4. Compila tutti i campi obbligatori e poi fai clic su Invia.