Quando um Formulário Google salva as respostas em uma planilha, cada resposta adiciona uma linha a Form Responses 1. Para agir sobre uma resposta assim que ela chega (direcioná-la, enviar um retorno, adicionar um ID), instale um acionador que execute sua função ao enviar o formulário:
ScriptApp.newTrigger("onIntake") seguido de .forSpreadsheet(SpreadsheetApp.getActive()), .onFormSubmit() e .create()
Execute essa função de configuração uma vez; o acionador permanece no projeto e aparece na lista de acionadores. newTrigger recebe o nome do manipulador como texto. Depois disso, cada resposta chama onIntake(e) com:
- e.values: as respostas como texto, na ordem das colunas, começando pelo Timestamp em e.values[0].
- e.namedValues: as respostas por pergunta, cada uma como uma matriz, então a equipe é e.namedValues["Team"][0].
- e.range: a nova linha na planilha de respostas.
Uma pergunta opcional sem resposta chega como uma string vazia. Executar o setup duas vezes instala dois acionadores, e então cada resposta é tratada duas vezes, por isso verifique ScriptApp.getProjectTriggers() antes. Executar onIntake pelo editor não tem evento, então e é undefined ali. Nesta cópia de prática, o verificador envia respostas de teste pelo seu acionador.
O manipulador lê a resposta do evento e a escreve onde ela deve ficar.