Se você usa 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^{(Google Apps Script)} . 

Pense no Google Apps Script como a versão do Google do script VBA da Microsoft^{(Microsoft’s VBA script)} . Assim como você pode automatizar ações e tarefas ou personalizar macros no Microsoft Word e Excel com VBA^{(Excel with VBA)} , você pode automatizar tarefas e ações nos serviços do Google . Em serviços como Planilhas e Documentos^(Docs) , você pode até escrever seus próprios menus personalizados.

Neste artigo, você aprenderá como acessar e ativar o Apps Script em seus vários serviços do Google^{(various Google services)} , como navegar no Apps Script Editor e como conectar serviços. Você não aprenderá funções específicas de script^{(learn specific script functions)} , mas o Google^(Google) tem uma excelente documentação e tutoriais de script de aplicativos disponíveis para aprender a escrever Apps Script .

Como acessar o Editor de scripts do Google Apps^{(Access Google Apps Script Editor)}

Você pode abrir o editor de código do Google Apps Script em vários serviços do ^{(Google Apps Script)}Google . Por exemplo, você encontrará o Apps Script no menu Extensões^(Extensions) dentro do Planilhas Google.

Em outros serviços, você pode abrir o editor de scripts do Google Apps das seguintes maneiras:^{(Google Apps Script)}

• Google Docs : selecione Editor de scripts^{(Script editor)} no menu Ferramentas^(Tools) .
• Apresentações Google^{(Google Slides)} : selecione Editor de scripts^{(Script editor)} no menu Ferramentas^(Tools) .
• Formulários Google^{(Google Forms)} : selecione Editor de scripts^{(Script editor)} no menu de três pontos.
• Google Drive : clique com o botão direito do mouse em qualquer espaço em branco, selecione Mais^(More) e selecione Google Apps Script .

Usando qualquer um desses métodos, você verá o editor de código do Apps Script aberto em uma nova guia. ^{(Apps Script)}Esta é a janela onde 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.

Nota^(Note) : A formatação do código é muito importante para evitar erros. Use comentários conforme mostrado no código a seguir para se lembrar do que você estava tentando fazer nas seções do código. Isso é muito semelhante a como os comentários funcionam no código HTML com a programação da web.

Conforme navega no editor de código, você pode retornar a esta seção selecionando Code.gs no painel de navegação esquerdo na janela Editor . Para ver outras janelas disponíveis, passe o mouse sobre os ícones no painel esquerdo e o painel de navegação principal será aberto.

A seção Visão geral^(Overview) é onde você pode encontrar estatísticas sobre seu script, como quantos erros ocorreram, quantas vezes ele foi executado e muito mais.

Abordaremos cada uma das outras seções do editor do Google Apps Script em cada seção abaixo.^{(Google Apps Script)}

Navegando no Editor de scripts do Google Apps^{(Google Apps Script Editor)}

À medida que você edita seu código no editor, é uma boa ideia selecionar o ícone do disco ( Salvar^(Save) ) com frequência para não perder seu trabalho.

Uma vez salvo, você verá as outras opções do menu se acenderem. 

Esses incluem:

• Executar^(Run) : Tente executar todo o script do início ao fim.
• Debug : Percorra seu script uma linha de cada vez.
• Lista suspensa de funções^{(Function dropdown)} : Navegue e navegue para cada uma das funções que você criou.
• Log de execução^{(Execution log)} : veja qualquer status ou mensagens de erro de cada tentativa que você fez para executar seu script.

A opção Bibliotecas^(Libraries) 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ê tiver um amigo que já escreveu um recurso que gostaria de usar no Planilhas Google^{(Google Sheets)} ou no Google Docs , mas gostaria de adicionar recursos adicionais.

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

Complementos dos serviços de script do Google Apps

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

Ao selecioná-lo, você verá a janela Adicionar um serviço aberta. ^{(Add a service)}Role^(Scroll) para baixo até o serviço que você deseja usar como complemento do seu projeto existente. 

For example, if you’d like to pull data from your Google Analytics account into this script, you can select the Google Analytics API, and select Add.

If you want to find details about what functions are available to use for that new add-on service and how to use them, select the three dots to the right of the API and select See documentation.

This will open the Google Apps Script documentation in a new tab, opened automatically to the section for that Google service.

Explore the documentation for function syntax, tutorials, and code examples that you can use in your own 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 abriu originalmente o editor de código do Apps Script .

Por exemplo, se você abriu o editor no Planilhas Google^{(Google Sheets)} , verifique a seção Planilhas^(Sheets) no menu de documentação para ver as funções do Planilhas Google^{(Google Sheets)} que você pode usar em seu script.

Como configurar e usar acionadores do Apps Script^{(Using Apps Script Triggers)}

Outro recurso útil no Google Apps Script é a capacidade de definir acionadores com base em vários eventos ou programações.

Para configurar um novo acionador para seu script, selecione Acionadores^(Triggers) no menu de navegação à esquerda. Na nova janela Triggers que se abre, selecione o botão ^(Triggers)Add Trigger .

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

Observação^(Note) : muitas dessas opções dependem do serviço para o qual você está escrevendo seu script ou das APIs que você adicionou^{(the APIs that you’ve added)} .

Para configurar seu acionador, você precisará escolher:

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

Depois de selecionar Salvar^(Save) , você poderá ver uma mensagem "Falha na autorização do script " se for a primeira vez que você salva um novo gatilho.

Isso geralmente é acionado se você tiver um bloqueador de pop-up ativado em seu navegador. Se você estiver usando o Google Chrome^{(Google Chrome)} , basta selecionar o ícone de janela pequena com um “X” vermelho sobre ele. Altere a configuração para Sempre permitir pop-ups^{(Always allow pop-ups)} e selecione Concluído^(Done) .

Ao selecionar Salvar^(Save) novamente, você precisará percorrer o processo para autorizar a execução do script que escreveu em sua conta do Google ou Google Workspace .

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

Você verá um aviso de que a função personalizada ou o script que você escreveu não foi "verificado" pelo Google . Se você é a pessoa que escreveu o script, isso não importa e é seguro executá-lo em sua própria Conta^{(Google Account)} do Google ou Google Workspace .

Para ignorar esse aviso, basta selecionar Avançado^(Advanced) e, em seguida, selecionar o link Go to <project> (unsafe)

Por fim, na janela de permissões, selecione Permitir^(Allow) para permitir que suas funções personalizadas e script sejam executados em sua conta do Google ou Google Workspace .

Você não precisará repetir esse processo novamente, somente na primeira vez que salvar ou executar seus projetos de script  personalizados do Google Apps .

Acessando seu ID do Google Script

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 sua ID de script^{(Script ID)} no ícone Configurações^(Settings) no painel de navegação à esquerda.

O Script ID pode ser encontrado na seção IDs , à direita de Script ID .

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

Google Apps Script Editor: Everything You Need to Know to Get Started

If you use Goоgle services like Google Docs, Google Sheets, Google Analytics, Gmail, and others, you could connect and automate those services uѕing Google Aрps Script. 

Think of Google Apps Script like Google’s version of Microsoft’s VBA script. Just like you can automate actions and tasks or customize macros in Microsoft Word and Excel with VBA, you can automate tasks and actions across Google services. In services like Sheets and Docs, you can even write your own custom menus.

In this article you will learn how to access and enable Apps Script in your various Google services, how to navigate the Apps Script Editor, and how to connect services. You won’t learn specific script functions, but Google has excellent documentation and apps script tutorials available to learn how to write Apps Script.

How to Access Google Apps Script Editor

You can open the Google Apps Script code editor from within a number of Google services. For example, you’ll find Apps Script in the Extensions menu inside Google Sheets.

In other services, you can open the Google Apps Script editor in the following ways:

• Google Docs: Select Script editor in the Tools menu.
• Google Slides: Select Script editor in the Tools menu.
• Google Forms: Select Script editor in the three-dot menu.
• Google Drive: Right-click any blank space, select More, and select Google Apps Script.

Using any of these methods, you’ll see the Apps Script code editor open in a new tab. This is the window where you’ll write each of the functions that make up your entire script. By default, you’ll see an empty function named myFunction() that’s ready for you to start filling in your code.

Note: Code formatting is very important in order to avoid errors. Use commenting as shown in the following code to remind yourself what you were trying to do inside sections of code. This is very similar to how commenting works in HTML code with web programming.

As you navigate the code editor, you can return to this section by selecting Code.gs in the left navigation pane in the Editor window. To see other available windows, hover over the icons in the far left pane and the main navigation pane will open.

The Overview section is where you can find statistics about your script like how many errors have occurred, how many times it’s executed, and more.

We’ll cover each of the other sections of the Google Apps Script editor in each section below.

Navigating the Google Apps Script Editor

As you edit your code in the editor, it’s a good idea to select the disk (Save) icon often so that you don’t lose your work.

Once saved, you’ll see the other menu options light up. 

These include:

• Run: Attempt to run your entire script from beginning to end.
• Debug: Step through your script one line at a time.
• Function dropdown: Browse through and navigate to each of the functions you’ve created.
• Execution log: See any status or error messages from each attempt you’ve made to run your script.

The Libraries option in the left navigation menu is where you can access libraries that other people have written (or you’ve written and saved elsewhere). This is useful if you have a friend who already wrote a feature you’d like to use in Google Sheets or Google Docs but you’d like to add additional features on top of that.

All you need to add those libraries into your project is the Script ID. You can find this in the project settings section, which we’ll show you how to find toward the end of this article.

Google Apps Script Services Add-Ons

The Services section is the most useful. It’s where you can integrate your current script with other Google services you may use. 

When you select it, you’ll see the Add a service window open. Scroll down to the service you want to use as an add-on to your existing project. 

For example, if you’d like to pull data from your Google Analytics account into this script, you can select the Google Analytics API, and select Add.

If you want to find details about what functions are available to use for that new add-on service and how to use them, select the three dots to the right of the API and select See documentation.

This will open the Google Apps Script documentation in a new tab, opened automatically to the section for that Google service.

Explore the documentation for function syntax, tutorials, and code examples that you can use in your own script.

Also, note that you can navigate to other sections of the documentation to see what general functions are available in your script based on the service you were using when you originally opened the Apps Script code editor.

For example, if you opened the editor in Google Sheets, check the Sheets section in the documentation menu for Google Sheets functions you’re able to use in your script.

Setting Up and Using Apps Script Triggers

Another useful feature in Google Apps Script is the ability to set triggers based on a number of events or schedules.

To configure a new trigger for your script, select Triggers from the far left navigation menu. In the new Triggers window that opens, select the Add Trigger button.

The Add Trigger window has a long list of options that help you customize exactly how and when you want your script to run. 

Note: Many of these options depend on the service you’re writing your script for or the APIs that you’ve added.

To set up your trigger, you’ll need to choose:

• Which function to initially launch
• The event source such as a specific time, date, or an event in your service like when a Google spreadsheet cell changes or a document is initially opened
• The event type such as when something in your Google spreadsheet or document is opened or edited, or the specific setting for date or time
• Notification frequency for how often you want to get updates about when your scripts have failed

Once you select Save, you may see a “Script authorization failed” message if it’s the first time you’ve saved a new trigger.

This is usually triggered if you have a pop-up blocker enabled in your browser. If you’re using Google Chrome, just select the small window icon with a red “X” over it. Change the setting to Always allow pop-ups and select Done.

When you select Save again, you’ll need to step through the process to authorize the script you’ve written to run under your Google account or Google Workspace.

First, select the Google account that you want to allow your script to run under.

You’ll see a warning that the custom function or script you wrote isn’t “verified” by Google. If you’re the person who wrote the script, then this doesn’t matter and it’s safe to run under your own Google Account or Google Workspace.

To bypass this warning, just select Advanced and then select the Go to <project> (unsafe) link at the bottom.

Finally, in the permissions window, select Allow to allow your custom functions and script to run under your Google account or Google Workspace.

You won’t have to repeat this process again, only the first time you save or run your custom Google Apps script projects. 

Accessing Your Google Script ID

One final note – you may want to provide your script to friends or colleagues so they can either use your script or add it as a library to their own script. 

You can find your Script ID under the Settings icon in the far left navigation pane.

The Script ID can be found under the IDs section, to the right of Script ID.

As you can see, the Google Apps Script editor is fairly straightforward if you know how to navigate to each feature you want to use. Just make sure to study Google’s Apps Script documentation well so that you can start learning how to write your scripts and all functions that are available to use.

Related posts

• Como os aplicativos experimentais do Google podem ajudá-lo a combater o vício digital

• Os 5 melhores aplicativos de filtro de luz azul para Windows, Mac e Linux

• 5 aplicativos portáteis que você definitivamente quer ter no seu pendrive

• Preenchimento automático do Google Chrome: um guia completo

• 4 melhores aplicativos de software de encaminhamento de porta e como usá-los

• O que é o Microsoft Power Automate e modelos gratuitos para download

• Configurações de conteúdo do Google Chrome: um guia completo

• Avast Online Security Extension: vale a pena usar?

• 3 ferramentas para diagnosticar e solucionar problemas com seu monitor

• Melhores Editores de Markdown: Todas as Plataformas e Online

• 5 aplicativos para localizar e remover arquivos duplicados no Windows 10

• Coisas a considerar antes de criar seu próprio Wiki

• Google Tradutor vs. Bing Tradutor – Qual é o melhor?

• Como os sites funcionam: saiba o que está por baixo do capô

• As 10 melhores extensões de privacidade para Chrome (2022)

• 5 melhores ferramentas de scanner de IP para Windows, Mac, iOS e Android

• Como usar um gerenciador de pacotes do Windows para instalar programas do Windows

• Os melhores complementos para potencializar seu pacote do Google Office

• Como usar o Google Tag Manager para analisar o tráfego do seu site

• Use uma Web Cam antiga para monitorar sua propriedade gratuitamente