Fundamentos do Apps Script com o Planilhas Google 5: gráficos e dados de apresentações no Apresentações

Fundamentos do Apps Script com o Planilhas Google 5:

gráficos e dados de apresentações no Apresentações

Sobre este codelab

Último abr. 4, 2022 atualizado

Escrito por Google Workspace Developer Relations

1. Introdução

Esta é a quinta parte da playlist de fundamentos do Apps Script com o Planilhas Google. Este codelab ensina como usar o serviço de planilhas no Apps Script para criar um gráfico de conjunto de dados. Você também aprenderá a usar o serviço do Apresentações para exportar o gráfico para um novo arquivo no Apresentações.

O que você vai aprender

• Como criar um gráfico de linhas com o Apps Script
• Como exportar gráficos para um novo arquivo do Apresentações
• Como apresentar caixas de diálogo ao usuário no Planilhas

Observação: neste codelab, você trabalhará principalmente com o serviço da planilha do Apps Script para criar e manipular gráficos incorporados.

O Apps Script também tem um serviço de gráficos dedicado. No entanto, ele é usado principalmente para criar e editar gráficos que podem ser usados em aplicativos fora do Planilhas Google. Este codelab não abrange esses casos de uso.

Antes de começar

Este é o quinto codelab da playlist "Fundamentos do Apps Script com o Planilhas Google". Antes de iniciar este codelab, conclua os codelabs anteriores:

1. Macros e funções personalizadas
2. Planilhas, Planilhas e intervalos
3. Como trabalhar com dados
4. Formatação de dados

Pré-requisitos

• Conhecimentos dos tópicos básicos do Apps Script explorados nos codelabs anteriores desta playlist.
• Ter noções básicas sobre o Editor do Apps Script
• Ter noções básicas sobre o Planilhas Google
• Capacidade de ler a notação A1 no Planilhas
• Ter noções básicas sobre o JavaScript e a classe String dele

2. Configurar

Para continuar, você precisa de uma planilha com alguns dados. Como antes, fornecemos uma planilha de dados que você pode copiar para esses exercícios. Siga estas etapas:

1. Clique neste link para copiar a planilha de dados e clique em Fazer uma cópia. A nova planilha será colocada na sua pasta Google Drive e será denominada "Copia de datas e taxas de câmbio em dólares americanos".
2. Clique no título da planilha e altere-a de "Texto de taxas de câmbio" para "Taxas de câmbio" e "Datas e dólares americanos". Sua planilha terá esta aparência, com algumas informações básicas sobre as diferentes taxas de câmbio em datas diferentes:

3. Para abrir o editor de script, clique em Extensões> Apps Script.

Para economizar tempo, incluímos um pouco de código para configurar um menu personalizado nessa planilha. Talvez você tenha visto o menu aparecer quando a cópia da planilha foi aberta:

Observação: saiba mais sobre menus personalizados e onOpen() no codelab Como trabalhar com dados.

Importante: como a planilha copiada tem um projeto de script vinculado a ela, o momento em que a planilha é copiada e o projeto de script também é. Lembre-se de que isso é uma cópia do projeto de script original. As alterações feitas no texto não serão aplicadas ao original e vice-versa.

Com esta planilha e projeto, você está pronto para iniciar o codelab. Vá para a próxima seção e comece a aprender sobre gráficos e acionadores baseados em tempo.

3. Criar um gráfico no Planilhas com o Apps Script

Imagine que você queira criar um gráfico específico para visualizar um conjunto de dados. Você pode usar o Apps Script para criar, editar e inserir gráficos no Planilhas Google. Quando um gráfico está contido em uma planilha, ele é chamado de gráfico incorporado.

Os gráficos são usados para visualizar uma ou mais séries de dados. Para gráficos incorporados, os dados que eles apresentam geralmente são provenientes da planilha. Geralmente, quando os dados são atualizados na planilha, o Planilhas também atualiza automaticamente o gráfico.

Você pode usar o Apps Script para criar gráficos personalizados e incorporados do zero ou atualizar gráficos que já existem. Esta seção apresenta os conceitos básicos da criação de gráficos incorporados no Planilhas com o Apps Script e o serviço Spreadsheet.

Ressalva: você pode usar o Apps Script para executar várias tarefas com gráficos, mas há algumas ações que não podem ser realizadas. O serviço da planilha fornece várias classes do EmbeddedChart que oferecem a funcionalidade de gráficos, mas elas não abrangem todas as opções de configuração possíveis. Além disso, o Apps Script também usa a API Google Graph, que tem as próprias limitações.

Devido a esses limites, muitas vezes é útil usar o Apps Script para criar gráficos básicos ou editar primeiro e depois ajustar a formatação manualmente no Planilhas. Talvez você não consiga automatizar todos os processos relacionados a gráficos no Apps Script, mas é possível automatizar grande parte dele.

Implementação

Na sua cópia da planilha de dados, o conjunto de dados "Taxas de câmbio e datas" exibe as taxas de câmbio (de 1 dólar) de moedas diferentes em datas diferentes. Você implementará uma função do Apps Script que cria um gráfico para visualizar parte desses dados.

Siga estas etapas:

1. No editor do Apps Script, adicione a seguinte função no fim do script Code.gs do projeto do script, depois da função onOpen():

/**
 * Creates and inserts an embedded
 * line chart into the active sheet.
 */
function createEmbeddedLineChart() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartDataRange = sheet.getRange(
    'Dates and USD Exchange Rates dataset!A2:F102');
  var hAxisOptions = {
    slantedText: true,
    slantedTextAngle: 60,
    gridlines: {
      count: 12
    }
  };
  
  var lineChartBuilder = sheet.newChart().asLineChart();
  var chart = lineChartBuilder
    .addRange(chartDataRange)
    .setPosition(5, 8, 0, 0)
    .setTitle('USD Exchange rates')
    .setNumHeaders(1)
    .setLegendPosition(Charts.Position.RIGHT)
    .setOption('hAxis', hAxisOptions)
    .setOption("useFirstColumnAsDomain", true)
    .build();
 
  sheet.insertChart(chart);  
}

2. Salve seu projeto de script.

Revisão de código

O código que você adicionou implementa a função chamada pelo item de menu Gráfico "Dados e taxas de câmbio dos EUA" para criar um gráfico de linhas básico. Vamos analisar o código.

As primeiras linhas configuram as três variáveis a seguir:

• sheet: uma referência à página ativa atual.
• chartDataRange: o intervalo de dados que queremos visualizar. O código usa a notação A1 para especificar o intervalo que abrange as células A2 a F102 na página Datas e taxas de câmbio dos EUA. Ao nomear a página especificamente, garantimos que o item de menu funcionará mesmo se uma página diferente estiver ativa, já que o intervalo sempre cobre a posição dos dados. Começando na linha 2 significa que incluiremos os cabeçalhos das colunas e representaremos apenas as 100 datas mais recentes (linhas).
• hAxisOptions: um objeto JavaScript básico que inclui algumas informações de configuração que o código usa para configurar a aparência do eixo horizontal. Mais especificamente, ele define os rótulos de texto do eixo horizontal em um eixo de 60 graus e define o número de linhas de grade vertical como 12.

A próxima linha cria um objeto builder de gráfico de linha. Os gráficos incorporados ao Apps Script são criados usando um padrão de design do Builder. Uma explicação completa desse padrão de design está fora do escopo deste codelab. Por isso, por enquanto, entenda que o serviço Spreadsheet oferece várias classes EmbeddedChartBuilder. Para criar um gráfico, o código cria um objeto incorporado de builder de gráficos, usa os métodos dele para definir as configurações do gráfico e, em seguida, chama um método build() para criar o objeto EmbeddedChart final. Seu código nunca modifica o objeto EmbeddedChart diretamente, porque toda a configuração do gráfico é gerenciada pelas classes do builder.

O serviço de planilhas fornece uma classe EmbeddedChartBuilder mãe e várias classes builder (como EmbeddedLineChartBuilder) que herdam o padrão dela. As classes filhas permitem que o Apps Script forneça os métodos de configuração do gráfico do builder aplicáveis apenas a determinados tipos de gráfico. Por exemplo, a classe EmbeddedPieChartBuilder oferece um método set3D() que se aplica somente a gráficos de pizza.

No código, essa linha cria a variável de objeto lineChartBuilder do builder:

var lineChartBuilder = sheet.newChart().asLineChart();

O código chama o método Sheet.newChart() para criar um objeto EmbeddedChartBuilder e, em seguida, usa EmbeddedChartBuilder.asLineChart() para definir o tipo de builder como EmbeddedLineChartBuilder.

Em seguida, o código cria o gráfico usando lineChartBuilder. Essa parte do código é apenas uma série de chamadas de método para definir as configurações do gráfico, seguidas por uma chamada de build() para criar o gráfico. Como você viu nos codelabs anteriores, o código usa o encadeamento de métodos para que seja legível por humanos. Veja o que as chamadas de método estão fazendo:

• addRange(range): define o intervalo de dados exibido no gráfico.
• setPosition(anchorRowPos, anchorColPos, offsetX, offsetY): determina onde o gráfico é colocado na página. Aqui, o código está inserindo o canto superior esquerdo do gráfico na célula H5.
• setTitle(title): define o título do gráfico.
• setNumHeaders(headers): determina quantas linhas ou colunas no intervalo de dados devem ser tratadas como cabeçalhos. Aqui, o código usa a primeira linha do intervalo de dados como cabeçalhos, o que significa que o texto nessa linha é usado como rótulos para cada série de dados no gráfico.
• setLegendPosition(position): move a legenda do gráfico para o lado direito. Esse método usa a enumeração Charts.Position como um parâmetro.
• setOption(option, value): define opções complexas de gráfico. Aqui, o código define a opção hAxis como o objeto hAxisOptions. Há várias opções que você pode definir usando esse método. As opções e os possíveis valores para cada tipo de gráfico estão documentados na Galeria de gráficos da API de gráficos. Por exemplo, as opções que você pode definir para os gráficos de linhas estão descritas em Opções de configuração do gráfico de linhas. O método setOption(option, value) é um tópico avançado que convém evitar usá-lo até que você se sinta mais confortável com a criação de gráficos no Apps Script.
• build(): cria e retorna um objeto EmbeddedChart usando as configurações acima.

Por fim, o código chama Sheet.insertChart(chart) para colocar o gráfico criado na página ativa.

Resultados

Para ver a função de formatação em ação, faça o seguinte:

1. Salve seu projeto de script no editor do Apps Script, caso ainda não tenha feito isso.
2. Clique no item de menu Apresentar conjunto de dados > Gráfico &data e dólares americanos com taxa de câmbio".

Observação: se você estiver usando uma conta do gmail.com, poderá ver a caixa de diálogo ""Este app não foi verificado" ao usar o script pela primeira vez. O Google usa isso para avisar os usuários que talvez estejam usando o código de autores desconhecidos ou não confiáveis. Se você vir essa caixa de diálogo, poderá prosseguir, já que você é o autor do script. Siga as instruções na tela para continuar autorizando o script:

1. Na caixa de diálogo do app não verificado, clique em Avançado.
2. Clique em Acessar datas e taxas de câmbio (não seguras).
3. Clique em Allow.

Durante este codelab, você vai receber várias solicitações de permissão. Leia mais sobre esse processo em Autorização para serviços do Google.

O script agora coloca um novo gráfico à direita dos seus dados:

Parabéns! Você criou um gráfico de linhas incorporado com o Apps Script. A próxima seção ensina a exportar seu gráfico para o Apresentações Google.

4. Exportar seus gráficos para o Apresentações

Um dos pontos fortes do Apps Script é a migração fácil de dados de um aplicativo do Google Workspace para outro. A maioria desses aplicativos tem um serviço dedicado do Apps Script, semelhante ao serviço Planilhas. Por exemplo, o Gmail tem o serviço do Gmail, o Documentos Google tem o serviço de Documentos e o Apresentações Google tem o serviço do Apresentações. Com todos esses serviços integrados, você pode extrair dados de um aplicativo, processá-los e gravar o resultado em outro.

Nesta seção, você aprenderá a exportar todos os gráficos incorporados de uma planilha do Google para um novo arquivo do Apresentações Google. Você também verá duas formas de exibir mensagens personalizadas ao usuário no Planilhas.

Observação: ao usar o serviço do Apresentações, seus scripts podem criar objetos Presentation, preenchê-los com Slides e Layouts e adicionar PageElements, como Shapes, TextRanges e Lines. Para as opções, o serviço de slides é quase tão grande quanto o da planilha.

O Apps Script pode fazer várias coisas com o Apresentações, mas neste codelab você criará uma apresentação e criará slides e importará gráficos para slides. Para saber mais, acesse a documentação Estender o Apresentações Google.

Implementação

Aqui, você implementará a função chamada pelo item de menu Apresentar conjunto de dados & exportar gráficos para o Apresentações. Siga estas etapas:

1. No editor do Apps Script, adicione a seguinte função no fim do script Code.gs do projeto do script, depois da função createEmbeddedLineChart():

/**
 * Create a Slides presentation and export
 * all the embedded charts in this spreadsheet
 * to it, one chart per slide.
 */
function exportChartsToSlides() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // Fetch a list of all embedded charts in this
  // spreadsheet.
  var charts = [];
  var sheets = ss.getSheets();
  for (var i = 0; i < sheets.length; i++) {
    charts = charts.concat(sheets[i].getCharts());
  }
  
  // If there aren't any charts, display a toast
  // message and return without doing anything
  // else.
  if (charts.length == 0) {
    ss.toast('No charts to export!');
    return;
  }
  
  // Create a Slides presentation, removing the default
  // title slide.
  var presentationTitle =
    ss.getName() + " Presentation";
  var slides = SlidesApp.create(presentationTitle);
  slides.getSlides()[0].remove();  
  
  // Add charts to the presentation, one chart per slide.
  var position = {left: 40, top: 30};
  var size = {height: 340, width: 430};
  for (var i = 0; i < charts.length; i++) {
    var newSlide = slides.appendSlide();
    newSlide.insertSheetsChart(
      charts[i],
      position.left,
      position.top,
      size.width,
      size.height);   
  }
  
  // Create and display a dialog telling the user where to
  // find the new presentation.
  var slidesUrl = slides.getUrl();
  var html = "<p>Find it in your home Drive folder:</p>"
      + "<p><a href=\"" + slidesUrl + "\" target=\"_blank\">"
      + presentationTitle + "</a></p>";
  
  SpreadsheetApp.getUi().showModalDialog(
    HtmlService.createHtmlOutput(html)
      .setHeight(120)
      .setWidth(350),
      "Created a presentation!"
  );
}

2. Salve seu projeto de script.

Revisão de código

Esse código pode ser mais curto que o esperado. Vamos analisar o resultado dessa tarefa dividindo o código em cinco seções:

1: ver os gráficos

As primeiras linhas pesquisam a planilha ativa para encontrar todos os gráficos incorporados e os coletam na matriz charts. Essas linhas usam os métodos Spreadsheet.getSheets() e Sheet.getCharts() para criar listas de páginas e gráficos. O método Array.concat() do JavaScript é usado para anexar a lista de gráficos de cada página ao charts.

2: verificar se há gráficos para exportar

O código verifica se há gráficos para exportar. Queremos evitar a criação de uma apresentação em branco. Portanto, se não houver gráficos, o código criará uma mensagem toast usando Spreadsheet.toast(message). Esta é uma caixa de diálogo pequena, que aparece no canto inferior direito do Planilhas, permanece por alguns segundos e desaparece:

Importante: as mensagens de aviso são ótimas para mostrar ao usuário algo que aconteceu, mas não é algo que ele precisa reagir. Nesse caso, a mensagem de aviso informa ao usuário que a ação do menu foi concluída, mas não produziu nada porque não há gráficos a serem exportados.

Se o código não tiver criado a mensagem de aviso, parece que o item de menu não está fazendo nada e o usuário pode achar que o script está corrompido. É sempre uma prática recomendada manter os usuários informados sobre o que os scripts estão fazendo, mesmo que eles encontrem condições de erro.

Se não houver gráficos para exportar, o código criará a mensagem de aviso e sairá sem fazer mais nada. Se houver gráficos para exportar, o código continuará a criar uma apresentação nas próximas linhas.

3: Criar uma apresentação

A variável presentationTitle é criada para armazenar o nome do arquivo da nova apresentação. Ele é definido como o nome da planilha, com "quot; Presentation" concatenado no final. Em seguida, o código chama o método do serviço do Apresentações Google SlidesApp.create(name) para criar uma apresentação.

Observação:a classe SlidesApp funciona como a classe mãe do serviço do Apresentações, assim como a SpreadsheetApp é a classe pai do serviço do Planilhas.

As novas apresentações são criadas com um único slide em branco. Como não queremos isso na nossa apresentação, o código a remove com Presentation.getSlides() e Slide.remove().

4: exportar os gráficos

Na próxima seção, o código define a position e a size dos objetos JavaScript para definir onde os gráficos importados serão colocados no slide e qual será o tamanho do gráfico (em pixels).

Observação: os elementos de página do Apresentações, como gráficos importados, caixas de texto e formas, exigem posições e tamanhos específicos. Saiba mais sobre como o Apps Script define esses valores no guia Dimensionar e posicionar elementos de página.

O código faz um loop em cada gráfico da lista. Em cada gráfico, um newSlide é criado com o Presentation.appendSlide(), adicionando o slide ao fim da apresentação. O método Slide.insertSheetsChart(sourceChart, left, top, width, height) é usado para importar o gráfico para o slide com a position e o size especificados.

5: compartilhar o local da apresentação

Por fim, o código precisa informar ao usuário onde a nova apresentação está localizada, de preferência com um link em que ele possa clicar para abri-la. Para fazer isso, o código usa o HTML service do Apps Script para criar uma caixa de diálogo modal personalizada. As caixas de diálogo modais (também conhecidas como caixas de diálogo personalizadas no Apps Script) são exibidas na interface do Planilhas. Quando elas são exibidas, as caixas de diálogo personalizadas impedem que o usuário interaja com o Planilhas.

Importante:as caixas de diálogo modais são ótimas para quando o script precisar de uma entrada específica do usuário para continuar ou quando você quiser garantir que o usuário veja algo antes de continuar trabalhando no Planilhas Google.

O serviço HTML do Apps Script permite controlar completamente o estilo e o conteúdo de caixas de diálogo personalizadas com HTML e JavaScript padrão. Isso significa que você pode adicionar texto, botões, imagens e outras interatividades à caixa de diálogo. Esses tópicos estão fora do escopo deste codelab, mas se você quiser saber mais, acesse os guias Criar e veicular HTML e Comunicação entre cliente e servidor.

Para criar uma caixa de diálogo personalizada, o código precisa do HTML que define seu conteúdo. Isso é fornecido na variável html. O conteúdo inclui um parágrafo curto e um hiperlink. O hiperlink é a variável presentationTitle, vinculada ao URL da apresentação informado por Presentation.getUrl(). O hiperlink também usa o atributo target="_blank" para que a apresentação seja aberta em uma nova guia do navegador, e não na caixa de diálogo.

O HTML é analisado em um objeto HtmlOutput pelo método HtmlService.createHtmlOutput(html). O objeto HtmlOutput permite que o código defina o tamanho da caixa de diálogo personalizada com HtmlOutput.setHeight(height) e HtmlOutput.setWidth(width).

Depois que o htmlOutput é criado, o código usa o método Ui.showModalDialog(htmlOutput, title) para exibir a caixa de diálogo com o título fornecido.

Resultados

Agora que você implementou o segundo item do menu, poderá vê-lo em ação. Para testar a função exportChartsToSlides():

1. Salve seu projeto de script no editor do Apps Script, caso ainda não tenha feito isso.
2. Abra sua planilha e clique no item de menu Apresentar conjunto de dados > Gráfico &datas e dólares americanos taxa de câmbio" para criar um gráfico a ser exportado. Ele aparecerá ancorado na célula H5 da página ativa.
3. Clique no item de menu Apresentar conjunto de dados > Exportar gráficos para o Apresentações. Talvez você precise autorizar novamente o script.
4. Você verá o script processar a solicitação e exibir a caixa de diálogo personalizada.
5. Para abrir o novo arquivo do Apresentações, clique no link Datas e taxa de câmbio dos EUA:

Se quiser, você também poderá adicionar mais gráficos à sua planilha e selecionar novamente o item de menu para criar uma apresentação com vários slides.

Observação: os gráficos exibidos na apresentação são gráficos vinculados. Isso significa que elas ainda estarão conectadas ao gráfico original do Planilhas. Se você fizer uma edição no gráfico do Planilhas original, poderá atualizar o gráfico vinculado no Apresentações usando um botão Atualizar no gráfico. Também é possível forçar uma atualização usando o método SheetCharts.refresh().

Agora você pode exportar gráficos criados no Planilhas para um arquivo do Apresentações. Também é possível escrever um código para criar uma caixa de diálogo personalizada.

Você concluiu o exercício final deste codelab. Vá para a próxima seção e revise o que você aprendeu.

5. Conclusão

Parabéns! Você concluiu este codelab e a playlist completa de noções básicas do Apps Script com o Planilhas Google. Você pode usar os princípios ensinados nesta playlist para ampliar sua experiência no Planilhas e explorar os recursos do Apps Script.

Você achou este codelab útil?

SimNão

O que você aprendeu

• Como criar um gráfico de linhas incorporado com o Apps Script.
• Como apresentar mensagens de aviso e caixas de diálogo personalizadas para um usuário no Planilhas
• Saiba como exportar um gráfico para um novo arquivo do Apresentações.

Principais conceitos:

1. O serviço de planilha usa EmbeddedChart e as classes de builder associadas para criar e modificar gráficos que aparecem no Planilhas. O serviço Gráficos é usado para criar e modificar gráficos usados fora do Planilhas, como em apps da Web do Apps Script.
2. As mensagens de aviso são usadas no Planilhas para exibir uma mensagem de alerta de curta duração ao usuário, sem que ele precise fazer nada.
3. As caixas de diálogo personalizadas são caixas de diálogo modal criadas com HTML e JavaScript. Quando elas são exibidas, as caixas de diálogo personalizadas impedem que o usuário interaja com o Planilhas. As caixas de diálogo personalizadas são ótimas para pedir que o usuário insira informações que o script precisa executar ou que ele leia algo antes de continuar trabalhando no Planilhas.
4. Quando um arquivo com um script vinculado a contêiner é copiado, a cópia do arquivo retém uma cópia do script vinculado. Se você alterar a cópia, isso não será refletido no original e vice-versa.
5. Os gráficos vinculados no Apresentações são conectados ao gráfico original do Planilhas. Se você editar o gráfico original do Planilhas, poderá atualizá-lo no Apresentações para refletir as edições.

Termos-chave:

• Ativa (status): indica que a planilha, a planilha, o intervalo ou a célula especificada é a que o usuário da planilha está visualizando ou destacando.
• Célula ativa: a única célula destacada na página ativa com o foco do cursor em destaque.
• Intervalo ativo: um grupo de uma ou mais células destacadas na página ativa.
• Autorização: o processo de autorização do usuário para que o Apps Script acesse os dados do usuário nos Serviços do Google relevantes ou realize ações em nome do usuário.
• Script vinculado ao contêiner: é qualquer script vinculado e criado a partir de um documento do Google Workspace, como um arquivo do Planilhas ou Documentos Google.
• Caixa de diálogo personalizada: é uma janela de diálogo modal personalizável, criada em HTML e JavaScript usada para fornecer informações ou interatividade aos usuários. Quando elas são exibidas, as caixas de diálogo personalizadas impedem que o usuário interaja com o Planilhas.
• EmbeddedChart: um gráfico incorporado a uma planilha.
• EmbeddedChartBuilder: uma classe ou um builder usado para criar ou editar um EmbeddedChart.
• Função auxiliar: uma função, geralmente particular, chamada por outra pessoa para concluir uma pequena subtarefa. As funções auxiliares são usadas quando a subtarefa precisa ser concluída muitas vezes em diferentes locais.
• JSON: formato de arquivo para definir objetos de dados e as características deles a partir do texto.
• onOpen(): quando definido em um script, é um acionador simples que é disparado sempre que um arquivo é aberto ou atualizado.
• Gráfico vinculado: no Apresentações, um gráfico conectado a um gráfico original no Planilhas. Se você editar o gráfico original do Planilhas, poderá atualizá-lo no Apresentações para refletir as edições.
• Caixa de diálogo modal: acesse a caixa de diálogo personalizada.
• Apresentação: um arquivo do Apresentações Google residente no Google Drive. A classe Presentation permite acessar e modificar apresentações.
• Intervalo**: um grupo de uma ou mais células adjacentes em uma página. Com a classe Range**, você lê e atualiza intervalos em uma página.
• Editor de script: o editor de código no navegador para o Apps Script.
• Acionadores simples: um subtipo de acionadores no Apps Script com nomes de função de acionador reservados e determinadas restrições.
• Planilha**: uma única página de uma planilha Às vezes usado para fazer referência a um arquivo do Planilhas Google no Google Drive. Com a classe Sheet**, você pode acessar e modificar páginas.
• Slide: um único slide de uma apresentação. A classe Slide permite acessar e modificar slides.
• SlidesApp: essa classe serve como a classe pai para o serviço do Apresentações e fornece um ponto de partida para o código que lê ou manipula dados do Apresentações Google.
• SpreadsheetApp: essa classe serve como a classe pai para o serviço de planilhas e fornece um ponto de partida para o código que lê ou manipula dados do Planilhas Google.
• Arquivo**: um arquivo do Planilhas Google que reside no Google Drive. Com a classe Spreadsheet**, você pode acessar e modificar planilhas.
• Serviço do Planilhas: um serviço do Apps Script que permite criar, acessar e modificar arquivos do Planilhas Google.
• Aviso de aviso: uma caixa de diálogo de curta duração usada para informar os usuários sobre eventos ou processos no Planilhas Google.
• Acionadores: um evento vinculado a uma função do Apps Script. Quando ocorre um evento (como uma planilha aberta), o acionador dispara e dispara automaticamente a função associada do Apps Script.
• Serviço de busca de URL: o serviço do Apps Script que permite que os scripts se conectem a endpoints de URL para fazer solicitações e receber respostas.

A seguir

Você concluiu esta playlist. No entanto, ainda há mais informações sobre o Apps Script.

Confira estes recursos:

• Documentação do desenvolvedor do Apps Script
• Guias do Apps Script
• Documentação de referência do Apps Script
• Perguntas do Apps Script no StackOverflow (link em inglês)
• Amostras de código do Apps Script no GitHub

Divirta-se!

Você achou esta playlist do codelab útil?

SimNão

Quer ver mais codelabs do Apps Script no futuro?

SimNão