Conjunto de pruebas de Google Home

Cloud-to-cloud    SDK de Local Home

Google Home Test Suite es una aplicación web que te permite probar por tu cuenta tu Acción de casa inteligente. El Test Suite genera y ejecuta automáticamente casos de prueba basados en los dispositivos y rasgos asociados con tu cuenta. Cuando completes las pruebas, podrás ver los resultados.

Para usar Test Suite y enviar los resultados de tus pruebas a Google para obtener la certificación, consulta la página Prueba y comparte Acciones para la casa inteligente para obtener más información. Esta versión de Test Suite es específica para el desarrollo y el control de calidad.

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

  • Verifica que Report State y Request Sync estén implementados para tus dispositivos y rasgos.

  • Verifica que la intención QUERY esté implementada para tu dispositivo y que sus resultados coincidan con los de Report State.

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

Iniciar Test Suite

Cómo autoevaluar tu Acción

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

Para probar tu acción por tu cuenta, sigue estos pasos:

  1. En tu navegador web, abre Test Suite.

  2. Accede a Google con el botón de 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 para la casa inteligente.
    2. Haz clic en Siguiente.

  4. Configura los parámetros de configuración de la prueba:

    1. Si certificas tu integración de Cloud-to-cloud, deja sin modificar el valor predeterminado de Estado del informe/Tiempo de espera de la sincronización de la solicitud. Sin embargo, para las 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 integración de Cloud-to-cloud, asegúrate de que la opción Test Request Sync esté habilitada. Durante las pruebas, se te pedirá que agregues, actualices o quites un dispositivo, y que verifiques si la lista de dispositivos cambió en Home Graph. Los cambios en las acciones se realizan a través de la integración que estás probando. La integración que se está probando siempre debe tener al menos un dispositivo conectado al usuario del agente.

    3. Si usas un rasgo Scene, selecciona Rasgo de Test Scene.

    4. Si ejecutas el conjunto de pruebas para dispositivos de Local Home, selecciona Compatible con el SDK de Local Home.

      1. Selecciona Local Fulfillment o Seamless Setup.
      2. Haz clic en Supports Local Query si el dispositivo puede controlar la intención QUERY de forma local.

  5. Realiza una prueba de ejecución y visualiza los resultados:

    1. Haz clic en Siguiente para comenzar a ejecutar pruebas. La interfaz muestra los dispositivos y los rasgos que se están probando.

  6. Consulta la página Resultados y envío:

    1. Una vez que se completen las pruebas, haz clic en Siguiente para ver los resultados.

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

Prueba de validación de la vinculación de cuentas

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

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

Prueba de validación del token de acceso

Los tokens de acceso que se muestran desde tu extremo de intercambio de tokens se prueban para garantizar que tengan un formato válido y que se muestren 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 la Cuenta de Google no recomienda los tokens de acceso en formato JWT. Si se encuentra un formato de 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.
Comprueba que el token de acceso que puede vencer tenga un token de actualización. Se debe proporcionar un token de actualización cuando el token de acceso sea vencible. Esta prueba fallará si no se encuentra ningún token de actualización.

Prueba de validación del token de actualización

Los tokens de actualización se prueban para garantizar que tu extremo de intercambio de tokens los intercambie correctamente por tokens de acceso nuevos.

Elementos de prueba Explicación
Actualiza el token con un token de actualización no válido y verifica la respuesta del socio. Tu servidor debe mostrar un error HTTP 400 de solicitud incorrecta con {"error": "invalid_grant"} para 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á. Visita Intercambia tokens de actualización por tokens de acceso para obtener más información.
Prueba si el token de acceso se actualizó después de la actualización del token. Los tokens de acceso nuevos deben devolverse en respuesta a las solicitudes de tokens de actualización. Si tu servidor proporciona el mismo token de acceso, el caso de prueba fallará.
Verifica si el token de acceso sin vencer sigue siendo válido. Se mostrará la hora de vencimiento del token de acceso.
Comprueba si se rotó el token de actualización durante la actualización. Verificamos si los tokens de actualización cambian después de una solicitud de token de actualización. Si cambia el token de actualización, tu servidor solo debe invalidar un token de actualización anterior después de que se haya usado un token de actualización nuevo para evitar condiciones de carrera que puedan interrumpir la vinculación de la cuenta de un 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 resolver el problema
La API de HomeGraph no se usó en el proyecto <_id_> anteriormente o está inhabilitada 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 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 datos del módulo: Error de getModuleData: Respuesta de error de Http para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. Sigue las instrucciones en Soluciona problemas de permisos de IAM para asegurarte de que tu cuenta tenga los permisos de 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 "Test suite for smart home":
    • 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úblicos
    • Acceso adicional
      1. Usa tu Assistant: Acceso amplio a tu cuenta de Google
      2. Inspeccionar y controlar los dispositivos inteligentes para la casa en 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

Tus resultados de Test Suite deben aprobar el 100% de las pruebas antes de enviar la solicitud de certificación. Si tienes algún rasgo que requiera pruebas manuales, debes ejecutar la herramienta Test Suite y adjuntar el resultado, incluso si no pasó al 100%.

Para enviar los resultados de las pruebas y certificar tu integración de Cloud-to-cloud, sigue estos pasos:

  1. Después de recibir los resultados de las pruebas y cuando esté todo listo para certificar tu integración de Cloud-to-cloud, haz clic en Enviar en la herramienta de Test Suite.
  2. Ve a Google Home Developer Console > Cloud-to-cloud > Certificar.
  3. Selecciona la integración que deseas certificar.
  4. En Documentación, ingresa tu ID de resultados de Test Suite.

  5. Completa todos los campos obligatorios y, luego, haz clic en Enviar.