Conjunto de pruebas de Google Home

De nube a nube    SDK de Local Home .

Google Home Test Suite es una aplicación web que te permite hacer lo siguiente: hacer una autoprueba de la Acción de tu casa inteligente. El Test Suite genera y ejecuta automáticamente casos de prueba en función de los dispositivos y las características asociado a tu cuenta. Cuando completes las pruebas, podrás ver el contenido o complete el formulario de envío para enviar los resultados de la prueba a Google.

Las pruebas que ejecuta Test Suite incluyen, pero no se incluyen se limita a lo siguiente:

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

  • Verifica que el intent QUERY se implementa para tu dispositivo y sus resultados coinciden con los resultados del estado del informe.

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

Iniciar Test Suite

Cómo autoprobar tu Acción

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

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

  1. En tu navegador web, abre la 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 para 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, no cambies el valor predeterminado de Report State/Request Sync Timeout. Sin embargo, para puedes cambiar el valor del tiempo de espera si tu agente tarda más estado del informe a Home Graph.
    2. Si certificas tu Acción para casa inteligente, asegúrate de que la Sincronización de solicitudes de prueba esté habilitada. Durante la prueba, se te pedirá que agregues, actualizar o quitar un dispositivo, y ver si cambió la lista de dispositivos en Home Graph. Las acciones de cambio se llevan a cabo a través de la integración con la que y pruebas. Tu integración a prueba siempre debe tener al menos un dispositivo adjunta al usuario agente.

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

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

      1. Selecciona Local Fulfillment o Configuración fluida.
      2. Haz clic en Admite consultas locales si el dispositivo puede procesar el intent QUERY. de forma local.
  5. Realiza una ejecución de prueba y visualiza 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. Consulta los resultados y Página de 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 fallidas, y un puntuación que indica el porcentaje de pases.

Prueba de validación de vinculación de cuentas

La vinculación de cuentas reproduce un en el ecosistema de casa inteligente de Google. La prueba de validación de vinculación de cuentas en Test Suite verifica si hay posibles problemas en tu servicio de OAuth.

La prueba de validación de vinculación de cuentas contiene pruebas para validar los tokens de acceso. y 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 se muestren con un token de actualización válido.

Elementos de prueba Explicación
Verifica si el token de acceso está en formato JWT La vinculación de cuentas de Google no recomienda tokens de acceso en 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.
Comprueba que el token de acceso con vencimiento tenga un token de actualización. Se debe proporcionar un token de actualización cuando el token de acceso venza. Esta prueba fallará si no se encuentra un token de actualización.

Prueba de validación del token de actualización

Los tokens de actualización se prueban para garantizar que el extremo de intercambio de tokens sea correcto los intercambia por nuevos tokens de acceso.

Elementos de prueba Explicación
Token de actualización con un token de actualización no válido. Se está verificando la respuesta del socio. Tu servidor debería mostrar un error HTTP 400 de solicitud incorrecta con {"error": "invalid_grant"} por 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 actualizarlo. Se deben mostrar nuevos tokens de acceso en respuesta al token de actualización. solicitudes. Si tu servidor proporciona el mismo token de acceso, el caso de prueba fallará.
Verifica si el token de acceso no vencido sigue siendo 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. Comprobamos si los tokens de actualización cambian después de una solicitud de token de actualización. Si cambia el token de actualización, el servidor solo debería invalidar una actualización anterior. después de usar un nuevo token de actualización para evitar condiciones de carrera que pueden interrumpir la vinculación de cuentas de un usuario. La prueba fallará si invalidar el token de actualización anterior antes de usar el nuevo.

Mensajes de error

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

Mensaje de error Cómo resolverlo
No se usó la API de HomeGraph en el proyecto <_id_> antes o está inhabilitado 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 otorgaste todos los los permisos en la pantalla de consentimiento.

Se produjo un error cuando se obtenían los datos del módulo: error getModuleData: respuesta de falla HTTP. para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. Sigue las instrucciones que se indican en Solución de problemas de IAM para asegurarte de que tu cuenta Los permisos resourcemanager.projects.get para el proyecto.
  2. Ve a la página Apps que pueden acceder a tu cuenta para consultar la los siguientes permisos para "Probar el paquete de aplicaciones para la 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 personales que hayas disponibles públicamente
    • Acceso adicional
      1. Usa tu Assistant: Acceso amplio a tu Cuenta de Google
      2. Inspeccionar y controlar los dispositivos de casa inteligente de tu casa Gráfico
    Si ves un error de permiso, primero quita el acceso y otorga todos los en la pantalla de consentimiento cuando vuelvas a acceder.

Cómo enviar los resultados de la prueba

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

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

  1. Cuando recibas los resultados de tu prueba y tengas todo listo para certificar tus acción principal, haz clic en Enviar en la herramienta de Test Suite.
  2. Haz clic en el botón DESCARGAR LOS RESULTADOS DE LA PRUEBA para ver los resultados.
  3. Haz clic en IR AL FORMULARIO DE ENVÍO para enviar los resultados de la prueba a Google.
  4. Completa todos los campos obligatorios y haz clic en Enviar.