Criar automações residenciais avançadas com o editor de script

Com o app Google Home, você pode automatizar a casa usando rotinas. E se você quiser criar Rotinas da família avançadas, o editor de script permite programar automações com mais ativações, condições, ações e lógicas complexas.

No momento, o editor de script está disponível no Acesso antecipado. Você pode abrir o editor de script com o Google Home para Web ou no app Google Home para dispositivos móveis depois de entrar no Acesso antecipado.

Saiba como escrever automações com script:

• Programar automações usando o editor de script
• Lista completa de ativações, condições e ações compatíveis
• Lista de dispositivos compatíveis
• Codelab com um exemplo guiado de como criar seu primeiro script
• Prática adicional para escrever uma automação com script e exemplos de scripts

Acessar o codelab

Para começar

O editor de script permite que você escreva e edite Rotinas da família usando o Google Home para Web ou o app Google Home.

Para criar automações com script, você precisa entender o seguinte:

• Princípios básicos do YAML, uma linguagem de script legível por humanos que permite digitar instruções linha por linha para criar automações residenciais
• Como as Rotinas funcionam e a terminologia relacionada a elas, como ativações e ações
• Como usar o editor de script para programar automações

Se quiser mais detalhes, consulte o artigo sobre programar automações usando o editor de script.

Observação: no app Google Home para iPhone ou iPad, você pode ver, editar, desativar e iniciar automações, mas não é possível criar novas automações com script no momento. Se você tem um iPhone ou iPad, recomendamos usar o Google Home para Web nesse caso.

Noções básicas do editor de script

O editor de script usa YAML, uma linguagem que permite inserir instruções linha por linha para criar automações residenciais. Saiba mais sobre como programar automações usando o editor de script.

Criar, editar e excluir automações com script

Use o editor de script no Google Home para Web ou no app Google Home para criar e editar automações personalizadas.

Criar uma automação com script

Editar uma automação com script

Você pode conferir e editar a maioria das automações criadas com o editor de script. Automações que não usam script ou que estão em execução não podem ser modificadas no editor de script. Interrompa a automação para poder editar.

Com o app Google Home

1. Abra o app Google Home ..
2. Toque em Automações o nome da automação com script Editar.
3. Faça as mudanças.
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 ter acesso rápido e fácil, marque os dispositivos, salas, automações e ações mais usados nos Favoritos no app Google Home. Saiba mais sobre como criar e personalizar os Favoritos.

Excluir uma automação com script

Importante: a exclusão ou automação de uma Rotina é permanente. Você pode fazer pausas temporárias.

Ajuda com automações usando scripts

• Receba ajuda com scripts e saiba em que outras pessoas estão trabalhando na comunidade de automação do Google Home.
• Para que as automações funcionem, os scripts precisam usar um código válido. Se houver um erro, vai aparecer uma mensagem. Saiba mais sobre erros e avisos de validação.
• Para validar seu código, clique ou toque em Validar no editor de script. Consulte a seguir como evitar alguns erros comuns:
  • Use o nome correto do dispositivo no formato Nome do dispositivo - Nome do ambiente. Se não tiver certeza, verifique o nome do dispositivo no app Google Home.
  • Confira se o dispositivo é compatível com a função que você quer que ele execute. Você também pode usar o preenchimento automático para encontrar as opções disponíveis.
  • Inclua uma ação. As ações são necessárias para executar uma automação.
• Se o script for salvo, mas a automação não funcionar como esperado ou parar de funcionar, confirme manualmente se cada componente do script funciona. Por exemplo, se você escreveu um script para acender a luz e mudar o brilho depois do pôr do sol, tente concluir essas tarefas com um comando do Assistente para confirmar se cada função funciona. Também é possível verificar se:
  • o dispositivo foi adicionado ou vinculado ao app Google Home;
  • o dispositivo está conectado e on-line;
  • o nome do dispositivo e as ativações, condições e ações estão escritos corretamente; (Observação: os fabricantes podem mudar os atributos do dispositivo ao realizar atualizações, o que pode fazer com que os scripts parem de funcionar. Você pode usar o preenchimento automático para atualizar os scripts afetados.)
  • o script tem recuo e formatação adequados.
• Com o Google Home para Web, você pode acessar os registros de Automações abaixo do script para conferir o histórico e identificar possíveis problemas. Saiba mais sobre os tipos de mensagens exibidas nos registros de automação.
• Tente usar o recurso experimental de IA generativa do editor de script para descrever a automação que quiser e criar um script para você revisar e editar.
• Saiba mais sobre os princípios básicos das Rotinas e como resolver problemas relacionados.
• Consulte Praticar a escrita de um script.