Projetos de script

Um projeto de script representa uma coleção de arquivos e recursos no Google Apps Script, às vezes chamado de "um script". Um projeto de script tem um ou mais arquivos de script que podem ser arquivos de código (com uma extensão .gs) ou arquivos HTML (uma extensão .html). Você também pode incluir JavaScript e CSS em arquivos HTML.

O editor de script sempre tem um e apenas um projeto aberto por vez. É possível abrir vários projetos em várias janelas ou guias do navegador.

Criar e excluir projetos

Esta seção explica como criar e excluir projetos autônomos ou vinculados a contêineres do Apps Script.

Criar um projeto independente

Para criar um projeto independente no Apps Script:

1. Acesse script.google.com.
2. Clique em add Novo projeto.
3. No editor de script, clique em Projeto sem título.
4. Dê um nome ao projeto e clique em Renomear.

Criar um projeto independente no Google Drive

1. Abra o Google Drive.
2. Clique em Novo > Mais > Apps Script.

Criar um projeto vinculado a contêineres nos apps Google Docs, Google Planilhas ou Google Slides

1. Abra um documento do Google Docs, uma planilha do Google Sheets ou uma apresentação do Google Slides.
2. Clique em Extensões > Apps Script.
3. No editor de script, clique em Projeto sem título.
4. Dê um nome ao projeto e clique em Renomear.

Criar um projeto vinculado a contêineres no Google Formulários

1. Abra um arquivo no app Formulários.
2. Clique em Mais more_vert > Editor de script.
3. No editor de script, clique em Projeto sem título.
4. Dê um nome ao projeto e clique em Renomear.

Criar um projeto independente usando a ferramenta de linha de comando clasp

O clasp é uma ferramenta de linha de comando que cria, extrai/envia e implanta projetos do Apps Script em um terminal.

Consulte o guia da interface de linha de comando usando clasp para mais detalhes.

Excluir um projeto vinculado a um contêiner

Depois de excluir um projeto do Apps Script vinculado a um contêiner, não é possível recuperá-lo.

1. Abra o projeto vinculado ao contêiner usando um dos métodos descritos anteriormente.
2. No canto superior esquerdo, clique em Visão geral info_outline.
3. No canto superior direito, clique em Remover delete > Excluir definitivamente.

Somente o proprietário do contêiner pode ver as opções do menu de exclusão.

Excluir um projeto independente

1. Acesse script.google.com.
2. À direita do projeto que você quer excluir, clique em Mais more_vert > Remover > Remover.

Gerenciar arquivos em um projeto

Nesta seção, descrevemos como adicionar, excluir e exportar arquivos em um projeto do Apps Script.

Criar um arquivo

1. Abra seu projeto do Apps Script.
2. À esquerda, clique em Editor code > Adicionar add.
3. Selecione o tipo de arquivo a ser criado e dê um nome a ele.

Excluir um arquivo

1. Abra seu projeto do Apps Script.
2. À esquerda, clique em Editor code.
3. Ao lado do arquivo que você quer excluir, clique em Mais more_vert > Excluir.

Exportar arquivos de um projeto do Apps Script

Para exportar arquivos de código, copie e cole o código de cada arquivo no editor de texto que preferir ou use clasp na linha de comando. Para usar o clasp, consulte fazer o download de um projeto de script.

Definir o fuso horário de um projeto

Quando você define um fuso horário para um projeto do Apps Script, os scripts usam esse fuso horário ao serem executados.

1. Abra seu projeto do Apps Script.
2. À esquerda, clique em Configurações do projeto .
3. Na seção Fuso horário, selecione o fuso horário que você quer usar.

Para usar um fuso horário diferente em uma função específica, insira explicitamente o fuso horário nessa função. Por exemplo, na amostra a seguir, cada função cria um novo evento no Google Agenda. A primeira função usa o fuso horário do projeto por padrão. A segunda função especifica o fuso horário do Pacífico. Portanto, o evento é programado no horário do Pacífico, independente do fuso horário do projeto.

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

Corrigir problemas com várias Contas do Google

Se você fizer login em várias Contas do Google ao mesmo tempo, poderá ter problemas para acessar seus complementos e apps da Web. Não é possível fazer login múltiplo, ou seja, em várias Contas do Google ao mesmo tempo, em projetos, complementos ou apps da Web do Apps Script.

• Se você abrir o editor do Apps Script enquanto estiver conectado a mais de uma conta, o Google vai pedir para você escolher a conta que quer usar.

• Se você abrir um web app ou complemento e tiver problemas com o login múltiplo, tente uma das seguintes soluções:

  • Saia de todas as Contas do Google e faça login apenas na conta que tem o complemento ou app da Web que você quer acessar.
  • Abra uma janela anônima no Google Chrome ou uma janela de navegação anônima equivalente e faça login na Conta do Google que tem o complemento ou app da Web que você quer acessar.