Crear automatizaciones del hogar avanzadas con el editor de secuencias de comandos

Con la aplicación Google Home, puedes automatizar tu casa con rutinas. Para crear rutinas de la casa avanzadas, el editor de secuencias de comandos te permite programar automatizaciones con activadores, condiciones, acciones y funciones de lógica avanzada adicionales.

El editor de secuencias de comandos está disponible en la Vista Previa Pública. Puedes acceder a él con Google Home para la Web o en la aplicación Google Home para móviles después de unirte a la Vista Previa Pública.

Aprende a escribir automatizaciones con secuencias de comandos:

• Escribir automatizaciones con el editor de secuencias de comandos
• Lista completa de activadores, condiciones y acciones compatibles
• Lista de dispositivos compatibles
• Consulta nuestro codelab para ver un ejemplo guiado de cómo crear tu primera secuencia de comandos.
• Práctica adicional sobre cómo escribir una automatización con secuencias de comandos y ejemplos de secuencias de comandos

Visitar codelab

Empezar

El editor de secuencias de comandos te permite crear y editar tus propias rutinas de la casa con Google Home para la Web o en la aplicación Google Home.

Para crear automatizaciones con secuencias de comandos, necesitarás lo siguiente:

• Comprender los conceptos básicos de YAML, un lenguaje de secuencias de comandos legible por humanos que te permite introducir instrucciones línea por línea para crear automatizaciones del hogar.
• Comprender cómo funcionan las rutinas y entender términos como "activadores" y "acciones".
• Comprender cómo utilizar el editor de secuencias de comandos para escribir automatizaciones.

Para obtener información más detallada sobre cómo escribir una secuencia de comandos, consulta el artículo Escribir automatizaciones con el editor de secuencias de comandos.

Nota: En un iPhone o iPad, puedes ver, editar, desactivar y ejecutar automatizaciones en la aplicación Google Home, pero actualmente no se pueden crear automatizaciones con secuencias de comandos. Si tienes un iPhone o iPad, te recomendamos que uses Google Home para la Web si quieres crear nuevas automatizaciones.

Conceptos básicos del editor de secuencias de comandos

El editor de secuencias de comandos utiliza YAML, un lenguaje que permite introducir instrucciones línea por línea para crear automatizaciones del hogar. Para obtener más información, consulta el artículo Escribir automatizaciones con el editor de secuencias de comandos.

Guía de referencia rápida de YAML

Conceptos de YAML	Ejemplos
Pares clave-valor YAML se escribe como una colección de pares clave-valor separados por : y un espacio. Cada par clave-valor comienza en una nueva línea. Una clave es una palabra clave literal. El valor asociado a una clave puede ser tan sencillo como una cadena, un número o una fecha, o tan complejo como otra colección de pares clave-valor. En el ejemplo, la clave es "name" y el valor es "TV on lights off".	name: TV on lights off
Sangrías y pares clave-valor anidados Puedes "anidar" varios pares clave-valor bajo una misma clave superior. YAML utiliza una sangría (2 espacios) para indicar la estructura y la jerarquía, así como para definir elementos anidados. Por cada nivel de anidación se aplica una sangría del mismo número de espacios. En el ejemplo, la clave superior es metadata. El valor de esta clave son dos pares clave-valor anidados: Par 1: la clave es name y el valor es TV on lights off Par 2: la clave es description y el valor es Turn off lights when TV turns on Cada par tiene una sangría de 2 espacios para mostrar que es un elemento secundario de la clave metadata.	metadata: name: TV on lights off description: Turn off lights when TV turns on
Varios valores Para incluir varios valores con una sola clave, crea una lista. Utiliza un guion antes de cada elemento de la lista. En el ejemplo, la clave es weekday y el valor es una lista que incluye Monday y Thursday.	weekday: - MONDAY - THURSDAY
Comentarios Las líneas que empiezan por # son comentarios que el motor de automatización ignorará.	# This is a comment. It will be ignored.

Activadores, condiciones y acciones compatibles

Definirás los comportamientos de tus automatizaciones con claves llamadas activadores, condiciones y acciones:

• Los activadores indican a la automatización cuándo debe empezar. Los activadores pueden incluir horas específicas o estados de dispositivos. Una automatización puede incluir más de un activador.
• Las condiciones son restricciones sobre cuándo debe ejecutarse tu automatización. Las condiciones se comprueban cada vez que se inicia una automatización. Por ejemplo, puedes especificar que la automatización solo se ejecute si estás fuera de casa o a partir del atardecer.
• Las acciones son lo que hará la automatización, como ajustar el volumen del altavoz, o encender o apagar una luz.

Para ver una lista de todos los activadores, las condiciones y las acciones, visita el Centro para Desarrolladores de Google Home. Cada uno de estos componentes tiene su propio conjunto de instrucciones y su propio formato. Haz clic en una entrada de la tabla de activadores, condiciones y acciones compatibles para ver instrucciones específicas, indicaciones sobre el formato y ejemplos de código. También puedes consultar cuáles de tus dispositivos son compatibles, así como las acciones y los comandos que pueden usar.

Crear, editar y eliminar automatizaciones con secuencias de comandos

Usa el editor de secuencias de comandos de Google Home para la Web o la aplicación Google Home para escribir y editar automatizaciones personalizadas con secuencias de comandos.

Importante: Todos los miembros de la unidad familiar pueden comprobar cuándo se ejecutan estas rutinas. Las rutinas están pensadas únicamente para la comodidad de los usuarios, y no se deben usar en casos prácticos esenciales para la seguridad. No crees rutinas que puedan provocar lesiones o daños si no se inician o se detienen. Su correcto funcionamiento puede depender de la conexión a Internet, la red Wi-Fi y la disponibilidad de los servicios de Google y de terceros que fabrican los dispositivos incluidos en las rutinas. Es posible que las rutinas no siempre funcionen. Google no se responsabiliza de los daños ni de las pérdidas que se produzcan como resultado del fallo de alguna rutina.

Crear una automatización con secuencias de comandos

Con la aplicación Google Home

1. Abre la aplicación Google Home ..
2. Toca Automatizaciones ..
3. Toca Añadir Casa Más opciones Editor de secuencias de comandos.
4. Crea un borrador de la nueva automatización con secuencia de comandos. Consulta el artículo Escribir automatizaciones con el editor de secuencias de comandos si necesitas ayuda para estructurar la secuencia de comandos.
5. Toca Validar para verificar que la secuencia de comandos se ejecuta. No se puede activar una automatización con errores.
6. Toca Guardar para añadir la automatización a tu casa o guardar tu progreso. Si la secuencia de comandos es válida al guardarla, la automatización se activará automáticamente. Si aún no quieres que se ejecute, desactiva la opción Activar.

Con Google Home para la Web

1. Abre home.google.com/automations e inicia sesión con tu cuenta.
2. Click Add new.
3. Crea un borrador de la nueva automatización con secuencia de comandos. Consulta el artículo Escribir automatizaciones con el editor de secuencias de comandos si necesitas ayuda para estructurar la secuencia de comandos.
4. Click Validate to verify your script is able to run. You can't activate an automation with errors.
5. Click Save to add your automation to your home or save in-progress work. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

Editar una automatización con secuencia de comandos

Puedes ver y editar la mayoría de las automatizaciones que hayas creado con el editor de secuencias de comandos. En dicho editor, no se pueden modificar las automatizaciones que no incluyen secuencias de comandos ni las que se están ejecutando. Cuando hayas detenido una automatización, podrás editarla.

Con la aplicación Google Home

1. Abre la aplicación Google Home ..
2. Toca Automatizaciones . el nombre de la automatización con secuencia de comandos Editar.
3. Edita la automatización con secuencia de comandos.
4. Tap Validate to verify your script is able to run. You can't activate an automation with errors.
5. Tap Save. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

Para acceder de forma rápida y sencilla, fija los dispositivos, las habitaciones, las automatizaciones y las acciones que más uses a tus Favoritos en la aplicación Google Home. Consulta más información sobre cómo crear y personalizar Favoritos.

Con Google Home para la Web

1. Abre home.google.com/automations e inicia sesión con tu cuenta.
2. Selecciona la automatización con secuencia de comandos.
3. Edita la secuencia de comandos.
4. Click Validate to verify your script is able to run. You can't activate an automation with errors.
5. Click Save to add your automation to your home or save in-progress work. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

Eliminar una automatización con secuencia de comandos

Importante: Las rutinas o automatizaciones se eliminan de forma permanente. Para detener temporalmente una rutina o automatización, páusala.

Con la aplicación Google Home

1. Abre la aplicación Google Home ..
2. Toca Automatizaciones ..
3. Selecciona la rutina que quieras eliminar.
4. Toca Eliminar Eliminar rutina.

Con Google Home para la Web

1. Abre home.google.com/automations e inicia sesión con tu cuenta.
2. Haz clic en la automatización con secuencia de comandos .
3. Haz clic en Eliminar Eliminar.

Ayuda con las automatizaciones con secuencias de comandos

• Recibe ayuda con las secuencias de comandos y descubre lo que están haciendo otros usuarios en la comunidad de domótica de Google Home.
• Para que las automatizaciones funcionen, el código de las secuencias de comandos debe ser válido. Si tiene algún error, aparecerá un mensaje. Consulta más información sobre errores y advertencias de validación.
• Para validar tu código, toca o haz clic en Validar en el editor de secuencias de comandos. A continuación, se indican algunos errores habituales que debes tener en cuenta:
  • Asegúrate de utilizar el nombre de dispositivo correcto con este formato: Nombre del dispositivo - Nombre de la habitación. Si no sabes cuál es el nombre del dispositivo, consúltalo en la aplicación Google Home.
  • Asegúrate de que tu dispositivo sea compatible con la función que quieres que realice. También puedes usar la función de autocompletar para ver las opciones disponibles.
  • Asegúrate de incluir una acción. Las automatizaciones necesitan acciones para poder ejecutarse.
• Si la secuencia de comandos se guarda, pero la automatización no funciona según lo esperado o deja de funcionar, comprueba manualmente que cada uno de los componentes de la secuencia de comandos funcione. Por ejemplo, si has escrito una secuencia de comandos para encender la luz y cambiar el brillo al atardecer, prueba a completar esas tareas con un comando del Asistente para confirmar que cada acción funcione por separado. También puedes comprobar lo siguiente:
  • Que tu dispositivo se ha añadido o vinculado a la aplicación Google Home.
  • Que tu dispositivo está conectado y online.
  • Que el nombre del dispositivo, los activadores, las condiciones y las acciones están escritos correctamente.  Nota: Los fabricantes pueden cambiar características de los dispositivos al realizar actualizaciones, por lo que las secuencias de comandos podrían dejar de funcionar. Usa la función de autocompletar para actualizar las secuencias de comandos afectadas.
  • Que se han usado correctamente las sangrías y el formato en la secuencia de comandos.
• Con Google Home para la Web, puedes acceder a los registros de las automatizaciones (debajo de la secuencia de comandos) para ver el historial de tu automatización e identificar posibles problemas. Consulta más información sobre los tipos de mensajes que se muestran en los registros de automatización.
• Prueba la función de IA generativa experimental del editor de secuencias de comandos. Describe la automatización que quieres y la IA creará el borrador de una secuencia de comandos para que tú la revises y edites.
• Consulta más información sobre los conceptos básicos de las rutinas y cómo solucionar los problemas relacionados con ellas.
• Consulta la sección Práctica sobre cómo escribir una secuencia de comandos.