Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones de casa inteligente. Nota: Seguirás compilando acciones en la Consola de Actions.

Conjunto de pruebas de Google Home

Google Home Test Suite es una aplicación web que te permite autoprobar tu Acción de casa inteligente. La Test Suite genera y ejecuta casos de prueba automáticamente en función de los dispositivos y las características asociados con tu cuenta. Cuando completes las pruebas, podrás ver los resultados o completar el formulario de envío para enviarlos a Google.

Las pruebas que ejecuta el Test Suite incluyen, entre otras, las siguientes:

  • Comprueba que se hayan implementado el estado de informe y la sincronización de solicitudes para tus dispositivos y características.

  • Verifica que se haya implementado el intent QUERY en tu dispositivo y sus resultados coincidan con los resultados del estado del informe.

Para iniciar la herramienta Test Suite, haz clic en el siguiente botón:

Iniciar Test Suite

Autoprueba de tu acción

En la siguiente sección, se describe cómo ejecutar Test Suite en tu dispositivo y proyecto de acción de casa inteligente. Test Suite requiere que accedas para poder inspeccionar dispositivos en tu Google Home Graph y enviar comandos directamente a Google Assistant.

Para realizar una autoprueba de tu acción, sigue estos pasos:

  1. En tu navegador web, abre Test Suite.
  2. Accede a Google con el botón que se encuentra en la esquina superior derecha.

  3. Configura los Detalles del proyecto:

    1. En el campo ID del proyecto, ingresa el identificador del proyecto de tu Acción de casa inteligente.
    2. Haz clic en Siguiente.
  4. Establece la Configuración de prueba:

    1. Si certificas tu Acción de casa inteligente, deja el valor predeterminado Report State/Request Sync Timeout sin modificar. Sin embargo, para pruebas, puedes cambiar el valor de tiempo de espera si tu agente tarda más en informar el estado a Home Graph.
    2. Si certificas tu Acción de casa inteligente, asegúrate de que la opción Test Request Sync esté habilitada. Durante la prueba, se te pedirá que agregues, actualices o quites un dispositivo y verifiques si la lista de dispositivos cambió en Home Graph. Las acciones de cambio se llevan a cabo a través de la integración que estás probando. La integración en prueba siempre debe tener al menos un dispositivo conectado con el usuario del agente.

    3. Si usas la característica Scene, selecciona Prueba la característica de la escena.

    4. Si ejecutas el paquete de pruebas para dispositivos de casa local, selecciona Admite el SDK de Local Home.

      1. Selecciona Entrega local o Configuración fluida.
      2. Haz clic en Admite consultas locales si el dispositivo puede controlar el intent QUERY de forma local.
  5. Realiza una ejecución de prueba y observa los resultados:

    1. Haz clic en Siguiente para comenzar a ejecutar pruebas. La interfaz muestra los dispositivos y las características que se están probando.
  6. Vea la página Resultados y envíos:

    1. Cuando se completen las pruebas, haz clic en Siguiente para ver los resultados.

Los resultados de la prueba incluyen la cantidad de pruebas aprobadas y fallidas, y una puntuación final que indica el porcentaje de pases.

Prueba de validación de vinculación de cuentas

La vinculación de cuentas desempeña un papel importante en el ecosistema de casa inteligente de Google. La prueba de validación de vinculación de cuentas en Test Suite verifica tu servicio de OAuth en busca de posibles problemas.

La prueba de validación de vinculación de cuentas contiene pruebas para validar los tokens de acceso y los tokens de actualización:

Prueba de validación de token de acceso

Los tokens de acceso que muestra el extremo del intercambio de tokens se prueban para garantizar que tengan un formato válido y se muestran con un token de actualización válido.

Elementos de prueba Explicación
Verifica si el token de acceso tiene formato JWT La vinculación de Cuentas de Google no recomienda tokens de acceso con formato JWT. Si se encuentra un formato JWT, se muestra la siguiente advertencia: 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 que el token de acceso con vencimiento tenga un token de actualización. Se debe proporcionar un token de actualización cuando venza el token de acceso. Esta prueba fallará si no se encuentra ningún token de actualización.

Actualizar la prueba de validación de tokens

Los tokens de actualización se prueban para garantizar que el extremo del intercambio de tokens los intercambie de manera correcta con nuevos tokens de acceso.

Elementos de prueba Explicación
El token de actualización tiene un token de actualización no válido y se está verificando la respuesta del socio. Tu servidor debe mostrar un error HTTP 400 de solicitud incorrecta con {"error": "invalid_grant"} a una solicitud de token de actualización no válida. Si la respuesta no coincide con el “código o mensaje de error”, este caso de prueba fallará. Consulta Cómo intercambiar tokens de actualización por tokens de acceso para obtener más información.
Prueba si se actualizó el token de acceso después de la actualización. Se deben mostrar los nuevos tokens de acceso en respuesta a la actualización de solicitudes de tokens. Si tu servidor proporciona el mismo token de acceso, el caso de prueba fallará.
Verifica si el token de acceso sin vencimiento aún es válido. Se mostrará la hora de vencimiento del token de acceso.
Verifica si se rotó el token de actualización durante la actualización. Verificamos si se cambian los tokens de actualización después de una solicitud de token de actualización. Si el token de actualización cambia, el servidor solo debe invalidar un token de actualización antiguo después de que se use uno nuevo para evitar condiciones de carrera que puedan interrumpir la vinculación de la cuenta del usuario. La prueba fallará si invalidas el token de actualización anterior antes de que se use el nuevo.

Mensajes de error

En la siguiente tabla, se enumeran algunos mensajes de error comunes que puedes encontrar y la forma sugerida de resolverlos.

Mensaje de error Cómo resolverlo
La API de HomeGraph no se usó antes en el proyecto <_id_> o se inhabilitó Asegúrate de haber habilitado la API de HomeGraph.
No se encontró la entidad solicitada Verifica que tu agentUserId sea válido y esté vinculado a tu servicio.

Asegúrate de tener el permiso resourcemanager.projects.get en el proyecto ${your project id} y de haber otorgado todos los permisos en la pantalla de consentimiento.

Error al obtener los datos del módulo: error getModuleData: respuesta de falla de HTTP para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. Sigue las instrucciones que se indican en Cómo solucionar problemas de permisos de IAM a fin de asegurarte de que tu cuenta tenga los permisos resourcemanager.projects.get para el proyecto.
  2. Ve a la página Apps que pueden acceder a tu cuenta para verificar los siguientes permisos de la opción "Conjunto de pruebas para casa inteligente":
    • Información básica de la cuenta
      1. Consultar la dirección de correo electrónico principal de su Cuenta de Google
      2. Ver tu información personal, incluidos los datos que hayas hecho público
    • Acceso adicional
      1. Usa tu Assistant: Acceso ilimitado a tu Cuenta de Google
      2. Inspecciona y controla los dispositivos de casa inteligente de tu Home Graph
    Si recibes un error de permiso, primero quita el acceso y otorga todos los permisos en la pantalla de consentimiento cuando vuelvas a acceder.

Envía los resultados de la prueba

Los resultados de Test Suite deben aprobar el 100% de las pruebas antes de enviar el formulario de certificación. Si tienes alguna característica que requiera pruebas manuales, debes ejecutar la herramienta Test Suite y adjuntar el resultado, incluso si no se aprobó en el 100%.

Para enviar los resultados de la prueba y certificar la Acción de tu casa inteligente, sigue estos pasos:

  1. Una vez que recibas los resultados de la prueba y estés listo para certificar la acción de casa inteligente, haz clic en Enviar en la herramienta de Test Suite.
  2. Haga clic en el botón DESCARGAR RESULTADOS DE LA PRUEBA para recuperar los resultados.
  3. Haga clic en IR AL FORMULARIO DE ENVÍO para enviar los resultados de la prueba a Google.
  4. Llene todos los campos obligatorios y, luego, haga clic en Enviar.