Cloud-to-cloud SDK de Local Home
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.
Las pruebas que ejecuta Test Suite incluyen, entre otras, las siguientes:
Comprueba que el Estado del informe y la Sincronización de la solicitud estén implementados para tus dispositivos y características.
Verifica que el intent QUERY se haya implementado para tu dispositivo y que los resultados coincidan con los resultados del estado del informe.
Para iniciar la herramienta Test Suite, haz clic en el siguiente botón:
Realiza una autoprueba de tu acción
En la siguiente sección, se describe cómo ejecutar Test Suite en tu dispositivo y el proyecto de acción de casa inteligente. Para usar Test Suite, debes acceder a tu cuenta a fin de que pueda inspeccionar los dispositivos de tu Google Home Graph and send commands directly to Google Assistant ..
Para autoprobar tu acción, sigue estos pasos:
- En el navegador web, abre Test Suite.
Accede a Google con el botón que se encuentra en la esquina superior derecha.
Configura los Detalles del proyecto:
- En el campo ID del proyecto, ingresa el identificador del proyecto de tu Acción de casa inteligente.
- Haz clic en Siguiente.
Establece la Configuración de la prueba:
- Si certificas tu Acción de casa inteligente, no cambies el valor predeterminado Report State/Request Sync Timeout. 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.
Si certificas tu Acción de casa inteligente, asegúrate de que la opción Sincronizar solicitud de prueba esté habilitada. Durante la prueba, se te pedirá que agregues, actualices o quites un dispositivo, y comprueba si cambió la lista de dispositivos 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.
Si usas la característica Scene, selecciona Razón de la escena de prueba.
Si ejecutas el conjunto de pruebas para dispositivos Home locales, selecciona Admite el SDK de Local Home.
- Selecciona Entregas locales o Configuración sin interrupciones.
- Haz clic en Admite consultas locales si el dispositivo puede controlar el intent QUERY de forma local.
Realiza una ejecución de prueba y visualiza los resultados:
- Haz clic en Siguiente para comenzar a ejecutar pruebas. La interfaz muestra los dispositivos y las características que se prueban.
Consulte la página Resultados y envíos:
- Una vez que se completen las pruebas, haz clic en Siguiente para ver los resultados.
Los resultados incluyen la cantidad de pruebas aprobadas y con errores, 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 una función importante en el ecosistema del hogar inteligente de Google. La prueba de validación de vinculación de la cuenta 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 el formato JWT. | La vinculación de Cuentas de Google no recomienda los 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.
|
Comprueba que el token de acceso con vencimiento tenga un token de actualización. | Se debe proporcionar un token de actualización cuando se pueda vencer. Esta prueba fallará si no se encuentra ningún token de actualización. |
Actualizar prueba de validación de token
Los tokens de actualización se prueban para garantizar que el extremo del intercambio de tokens los intercambien correctamente por tokens de acceso nuevos.
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 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 de error o mensaje”, este caso de prueba fallará. Si deseas obtener más información, consulta
tokens de actualización de intercambio para tokens de acceso. |
Prueba si se actualizó el token de acceso después de actualizarlo. | Se deben mostrar los nuevos tokens de acceso en respuesta a las solicitudes de actualización de tokens. Si el servidor proporciona el mismo token de acceso, el caso de prueba fallará. |
Comprueba 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. | 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 anterior después de usar uno nuevo, a fin de 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 usar 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 |
---|---|
No se usó la API de HomeGraph en el proyecto <_id_> antes o está inhabilitada | Asegúrate de haber habilitado la API de HomeGraph. |
No se encontró la entidad solicitada | Verifica que tu agentUserId sea válida y esté vinculada a tu servicio. |
Asegúrate de tener el permiso Error al obtener los datos del módulo: Error de getModuleData: Respuesta de falla de Http para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Enviar los resultados de la prueba
Los resultados de Test Suite deben aprobarse el 100% de las pruebas antes de enviar el formulario de certificación. Si tienes alguna característica que requiera una prueba manual, debes ejecutar la herramienta Test Suite y adjuntar el resultado, incluso si no se pasó al 100%.
Para enviar los resultados de la prueba y certificar una Acción de casa inteligente, sigue estos pasos:
- Una vez que recibas los resultados y estés listo para certificar tu acción de casa inteligente, haz clic en Enviar en la herramienta Test Suite.
- Haga clic en el botón DESCARGAR RESULTADOS DE LA PRUEBA para recuperar los resultados.
- Haga clic en IR AL FORMULARIO DE ENVÍO para enviar los resultados de la prueba a Google.
Llena todos los campos obligatorios y haz clic en Enviar.