Uma função chamada onEdit é um gatilho simples. Depois que o projeto é salvo, o Sheets a executa sempre que alguém edita uma célula, sem nenhuma configuração. Ela recebe um objeto de evento, normalmente chamado de e:
- e.range é a célula editada. getSheet().getName(), getRow() e getColumn() dizem onde ela está.
- e.value é o valor novo e e.oldValue o anterior, ambos como texto. Uma caixa de seleção marcada chega como "TRUE", não como o booleano true.
- e.source é a planilha, para acessar outras guias.
O onEdit é executado em toda edição do arquivo inteiro, então comece com cláusulas de guarda: se a edição não estiver na guia, na coluna ou na linha certa, use return antes de fazer qualquer coisa. Sem elas, uma mudança no cabeçalho ou uma edição em outra guia também aciona o seu código.
Gatilhos simples não podem fazer coisas que exigem a sua permissão, como enviar e-mail; para isso é preciso um gatilho instalável, na próxima lição. Nesta cópia de prática, as edições que você faz na grade executam o seu onEdit salvo, e o verificador passa uma série de edições por ele.
Primeiro as cláusulas de guarda, depois o trabalho para a única edição que importa.