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 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 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 > Google Apps Script.

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

1. Abra um arquivo do Documentos, Planilhas ou 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.

Crie 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 de um terminal.

Consulte o guia Interface de linha de comando usando clasp para ver 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 definitivamente.

Excluir um projeto independente

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

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 atribua 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 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 a página 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 função. No exemplo abaixo, cada função cria um novo evento no Google Agenda. A primeira função padrã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, seja qual for o 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, pode ter problemas para acessar seus complementos e apps da Web. O login múltiplo, ou o login em várias Contas do Google de uma só vez, não é compatível com o Apps Script, complementos ou apps da Web.

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

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

  • Saia de todas as suas 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 em uma janela de navegação anônima equivalente e faça login na Conta do Google que tem o complemento ou o app da Web que você quer acessar.