Projetos de script

Um projeto de script representa uma coleção de arquivos e recursos no Google Apps Script, às vezes chamado simplesmente de "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 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 do Apps Script independentes ou vinculados a contêineres.

Criar um projeto independente

Para criar um projeto independente do Apps Script:

1. Acesse script.google.com.
2. Clique em add New Project.
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 > Google Apps Script.

Criar um projeto vinculado a um contêiner nos apps Documentos, Planilhas ou Apresentações Google

1. Abra um documento do app Documentos, uma planilha do app Planilhas ou uma apresentação do app Apresentações.
2. Clique em Extensões > Google 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 um contêiner no Google Forms

1. Abra um arquivo no Formulários Google.
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 permite criar, extrair/enviar e implantar 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

1. Abra o projeto vinculado ao contêiner usando o método apropriado acima.
2. No canto superior esquerdo, clique em Visão geral info_outline.
3. No canto superior direito, clique em Remover delete > Excluir permanentemente.

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

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 extrair arquivos de código do Apps Script, copie e cole o código de cada arquivo no editor de texto que preferir ou use o 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

É possível definir o fuso horário de um projeto do Apps Script. As funções executadas pelo script usam esse fuso horário.

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.

Se você quiser que uma função específica use um fuso horário diferente do projeto do script, insira explicitamente o fuso horário na função. Por exemplo, no exemplo abaixo, cada função cria um novo evento no Google Agenda. A primeira função usa o fuso horário do projeto como padrão. A segunda função especifica o fuso horário do Pacífico, então 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ê estiver conectado a 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 fazer login 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 com login em mais de uma conta, o Google vai pedir que você escolha a conta que quer usar.

• Se você abrir um app da Web ou um complemento e tiver problemas de login múltiplo, tente uma destas soluções:

  • Saia de todas as suas Contas do Google e faça login apenas na 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 privada equivalente e faça login na Conta do Google que tem o complemento ou o app da Web que você quer acessar.