Editor de scripts do Google Apps tudo o que você precisa saber para começar

Se você usar serviços do Google como Google Docs, Google Sheets, Google Analytics, Gmail e outros, você pode conectar e automatizar esses serviços usando o Google Apps Script.

Pense no script do Google Apps, como a versão do Google do script VBA da Microsoft. Assim como você pode automatizar ações e tarefas ou personalizar macros no Microsoft Word e se destacar com o VBA, você pode automatizar tarefas e ações nos serviços do Google. Em serviços como folhas e documentos, você pode até escrever seus próprios menus personalizados.

Em outros serviços, você pode abrir o editor de scripts do Google Apps das seguintes maneiras:

• documentos Google: Selecione Editor de script no Ferramentas cardápio.
• Google slides: Selecione Editor de script no Ferramentas cardápio.
• Formulários do Google: Selecione Editor de script No menu de três pontos.
• Google Drive: Clique com o botão direito do mouse em qualquer espaço em branco, selecione Mais, e selecione Script do Google Apps.

Usando qualquer um desses métodos, você verá o editor de código de script de aplicativos aberto em uma nova guia. Esta é a janela em que você escreverá cada uma das funções que compõem todo o seu script. Por padrão, você verá uma função vazia chamada myfunction () que está pronta para você começar a preencher seu código.

Observação: A formatação de código é muito importante para evitar erros. Use comentar como mostrado no código a seguir para se lembrar o que você estava tentando fazer nas seções do código. Isso é muito parecido com a forma como os comentários funcionam no código HTML com a programação da web.

Ao navegar pelo editor de código, você pode retornar a esta seção selecionando Código.gs no painel de navegação esquerda no editor janela. Para ver outras janelas disponíveis, o mouse sobre os ícones no painel da extrema esquerda e o painel de navegação principal será aberto.

O Visão geral Seção é onde você pode encontrar estatísticas sobre seu script, como quantos erros ocorreram, quantas vezes é executado e mais.

Abordaremos cada uma das outras seções do editor de scripts do Google Apps em cada seção abaixo.

Navegando pelo editor de scripts do Google Apps

Ao editar seu código no editor, é uma boa ideia selecionar o ícone de disco (salvar) frequentemente para que você não perca seu trabalho.

Uma vez salvo, você verá as outras opções de menu iluminadas.

Esses incluem:

• Correr: Tente executar todo o seu script do começo ao fim.
• Depurar: Passe pelo seu script uma linha de cada vez.
• Suspensão da função: Navegue e navegue para cada uma das funções que você criou.
• Log de execução: Veja qualquer status ou mensagens de erro de cada tentativa que você fez para executar seu script.

O Bibliotecas Opção no menu de navegação esquerda é onde você pode acessar bibliotecas que outras pessoas escreveram (ou você escreveu e salvou em outro lugar). Isso é útil se você tem um amigo que já escreveu um recurso que gostaria de usar no Google Sheets ou Google Docs, mas você gostaria de adicionar recursos adicionais além disso.

Tudo o que você precisa para adicionar essas bibliotecas ao seu projeto é o ID do script. Você pode encontrar isso na seção Configurações do projeto, que mostraremos como encontrar no final deste artigo.

Google Apps Script Services complementos

O Serviços A seção é a mais útil. É onde você pode integrar seu script atual com outros serviços do Google que você pode usar.

Quando você o selecionar, você verá o Adicione um serviço Janela aberta. Role para baixo até o serviço que você deseja usar como um complemento para o seu projeto existente.

Por exemplo, se você quiser extrair dados da sua conta do Google Analytics neste script, você pode selecionar o API do Google Analytics, e selecione Adicionar.

Se você deseja encontrar detalhes sobre quais funções estão disponíveis para uso para esse novo serviço complementar e como usá-las, selecione os três pontos à direita da API e selecione Veja documentação.

Isso abrirá a documentação do script do Google Apps em uma nova guia, aberta automaticamente para a seção para esse serviço do Google.

Explore a documentação para sintaxe de função, tutoriais e exemplos de código que você pode usar em seu próprio script.

Além disso, observe que você pode navegar para outras seções da documentação para ver quais funções gerais estão disponíveis em seu script com base no serviço que você estava usando quando você abriu originalmente o editor de código de script de aplicativos.

Por exemplo, se você abriu o editor no Google Sheets, verifique o Folhas Seção no menu de documentação para as funções do Google Sheets que você pode usar em seu script.

Configurando e usando gatilhos de script de aplicativos

Outro recurso útil no script do Google Apps é a capacidade de definir gatilhos com base em vários eventos ou horários.

Para configurar um novo gatilho para o seu script, selecione Gatilhos Do menu de navegação da extrema esquerda. Na nova janela de gatilhos que abre, selecione o Adicione o gatilho botão.

A janela Add Trigger tem uma longa lista de opções que ajudam você a personalizar exatamente como e quando deseja que seu script seja executado.

Observação: Muitas dessas opções dependem do serviço que você está escrevendo seu script ou das APIs que você adicionou.

Para configurar seu gatilho, você precisará escolher:

• Qual função iniciar inicialmente
• A fonte do evento, como um horário, data ou evento específico em seu serviço, como quando uma célula do Google Spreadsheet muda ou um documento é inicialmente aberto
• O tipo de evento como quando algo na sua planilha ou documento do Google é aberto ou editado, ou a configuração específica para data ou hora
• Frequência de notificação para a frequência com que você deseja obter atualizações sobre quando seus scripts falharam

Depois de selecionar Salvar, Você pode ver uma mensagem "Autorização de scripts falhou" se for a primeira vez que você salvou um novo gatilho.

Isso geralmente é acionado se você tiver um bloqueador pop-up ativado no seu navegador. Se você estiver usando o Google Chrome, basta selecionar o pequeno ícone da janela com um "x" vermelho sobre ele. Altere a configuração para Sempre permita pop-ups e selecione Feito.

Quando você selecionar Salvar Mais uma vez, você precisará passar pelo processo para autorizar o script que você escreveu para executar em sua conta do Google ou no Google Workspace.

Primeiro, selecione a conta do Google com a qual você deseja permitir que seu script seja executado.

Você verá um aviso de que a função ou script personalizado que você escreveu não é "verificado" pelo Google. Se você é a pessoa que escreveu o script, isso não importa e é seguro correr sob sua própria conta do Google ou no Google Workspace.

Para ignorar este aviso, basta selecionar Avançado e então selecione o Vá para (inseguro) Link na parte inferior.

Finalmente, na janela de permissões, selecione Permitir Para permitir que suas funções e scripts personalizados sejam executados em sua conta do Google ou no Google Workspace.

Você não precisará repetir esse processo novamente, apenas na primeira vez que você salva ou executa seus projetos de script personalizados do Google Apps.

Acessando seu ID de script do Google

Uma nota final - você pode fornecer seu script a amigos ou colegas para que eles possam usar seu script ou adicioná -lo como uma biblioteca ao seu próprio script.

Você pode encontrar seu ID de script sob o ícone de configurações no painel de navegação da extrema esquerda.

O ID do script pode ser encontrado sob o Ids seção, à direita de ID do script.

Como você pode ver, o editor de scripts do Google Apps é bastante direto se você souber como navegar para cada recurso que deseja usar. Apenas certifique -se de estudar bem a documentação do script de aplicativos do Google para que você possa começar a aprender a escrever seus scripts e todas as funções disponíveis para uso.