Projetos de script

Um projeto de script representa um conjunto de arquivos e recursos no Google Apps Script, às vezes chamado 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). Também é possível incluir JavaScript e CSS em arquivos HTML.

O editor de script sempre tem um e apenas um projeto aberto a qualquer momento. É possível abrir diversos projetos em diversas janelas ou guias do navegador.

Criar e excluir projetos

Nesta seção, explicamos como criar e excluir projetos independentes ou de contêiner do Apps Script.

Criar um projeto autônomo

Para criar um projeto autônomo usando o 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 contêiner no Documentos, Planilhas ou Apresentações Google

1. Abra um documento do Documentos, uma planilha do Planilhas ou uma apresentação do 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 app Formulários Google

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 autônomo 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 Interface de linha de comando usando clasp para saber mais.

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 definitivamente.

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 > Add add.
3. Selecione o tipo de arquivo que você quer criar 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 remover os arquivos de código do Apps Script, copie e cole o código de cada arquivo no editor de texto de sua preferência ou use a clasp na linha de comando. Para usar a clasp, consulte fazer o download de um projeto de script.

Definir o fuso horário de um projeto

Você pode 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 que você quer usar.

Se você quiser que uma função específica use um fuso horário diferente do do projeto de script, insira explicitamente o fuso horário na sua função. No exemplo abaixo, cada função cria um novo evento no Google Agenda. O padrão da primeira função é o fuso horário do projeto. A segunda função especifica o fuso horário do Pacífico. Portanto, o evento é programado no horário do Pacífico, independentemente 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. O login múltiplo ou o login em várias Contas do Google ao mesmo tempo não é compatível com o Apps Script, complementos ou apps da Web.

• Se você abrir o editor do Apps Script enquanto estiver conectado em mais de uma conta, o Google solicitará que você escolha a conta que quer usar.

• Se você abrir um app da Web 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 naquela que tem o complemento ou o 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 app da Web que você quer acessar.