Projetos de script

Um projeto de script representa uma coleção de arquivos e recursos no Google Apps Script, às vezes chamado apenas de "quot;script" Um projeto de script tem um ou mais arquivos de script, que podem ser 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 em um determinado momento. É possível abrir vários projetos em várias janelas ou guias do navegador.

Criar e excluir projetos

Isso ensinará você a criar um projeto autônomo a partir do Google Drive e a criar um projeto vinculado a contêineres para cada um dos contêineres compatíveis.

Criar um projeto no Google Drive

  1. Abra o Google Drive.
  2. No canto superior esquerdo, clique em Novo > Mais > Google Apps Script.

Criar um projeto usando a ferramenta de linha de comando clasp

O clasp é uma ferramenta de linha de comando que permite criar, extrair/implantar e implantar projetos do Apps Script em um terminal.

Consulte o guia sobre a interface de linha de comando usando clasp para ver mais detalhes.

Criar um projeto usando o Google Sites clássico

Novo editor

  1. Abra um site Google clássico.
  2. Clique em Mais e selecione Gerenciar site.
  3. À esquerda, clique em Apps Script > Adicionar novo script.
  4. No canto superior esquerdo do editor de script, clique em Projeto sem título.
  5. Dê um nome ao projeto e clique em Renomear.

Editor legado

  1. Abra um site Google clássico.
  2. Clique em Mais e selecione Gerenciar site.
  3. Clique em Scripts do Google Apps no painel de navegação à esquerda.
  4. Clique em Adicionar novo script.
  5. Selecione Arquivo > Salvar.
  6. Digite o nome do projeto e clique em OK para salvá-lo.

Criar um projeto no Documentos ou no Planilhas Google

Novo editor

  1. Abra um arquivo do Documentos Google ou do Planilhas Google.
  2. Clique em Extensões > Apps Script.
  3. No canto superior esquerdo do editor de script, clique em Projeto sem título.
  4. Dê um nome ao projeto e clique em Renomear.

Editor legado

  1. Abra o Documentos ou o Planilhas Google.
  2. Selecione Extensões > Apps Script.
  3. Selecione Arquivo > Salvar.
  4. Digite o nome do projeto e clique em OK para salvá-lo.

Criar um projeto no Apresentações Google

Novo editor

  1. Abra um arquivo do Apresentações Google.
  2. Clique em Ferramentas > Editor de script.
  3. No canto superior esquerdo do editor de script, clique em Projeto sem título.
  4. Dê um nome ao projeto e clique em Renomear.

Editor legado

  1. Abra o Apresentações Google.
  2. Selecione Tools > Script editor.
  3. Selecione Arquivo > Salvar.
  4. Digite o nome do projeto e clique em OK para salvá-lo.

Criar um projeto no Formulários Google

Novo editor

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

Editor legado

  1. Abra um arquivo no Formulários Google.
  2. Clique em Mais > Editor de script.
  3. Selecione Arquivo > Salvar.
  4. Digite o nome do projeto e clique em OK para salvá-lo.

Excluir um projeto vinculado a um contêiner

Novo editor

  1. Abra seu projeto vinculado a um contêiner usando o método apropriado acima.
  2. No canto superior esquerdo, clique em Visão geral .
  3. No canto superior direito, clique em Remover > Excluir definitivamente.

Editor legado

  1. Abra seu projeto vinculado a um contêiner usando o método apropriado acima.
  2. Selecione File > Delete.
  3. Clique em Yes para excluir o projeto.

Excluir um projeto autônomo

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

Gerenciar arquivos em um projeto

Criar um arquivo

Novo editor

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

Editor legado

  1. Selecione File > New > Script file para criar um arquivo de script. Selecione File > New > HTML file para criar um arquivo HTML.
  2. Digite o nome do novo arquivo e clique em OK para criá-lo.

Excluir um arquivo

Novo editor

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

Editor legado

  1. Clique na seta ao lado do nome do arquivo no painel à esquerda.
  2. Selecione Excluir.
  3. Clique em Yes para excluir o arquivo.

Definir o fuso horário de um projeto

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

  1. Abra seu projeto do Apps Script.
  2. À esquerda, clique em Configurações do projeto Ícone de 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 da função do projeto de script, insira explicitamente o fuso horário na sua função. Por exemplo, na amostra abaixo, cada função cria um novo evento no Google Agenda. A primeira função é o padrão do 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ê fizer login em várias Contas do Google ao mesmo tempo, poderá ter problemas para acessar seus projetos, complementos e apps da Web do Apps Script. 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.

Para corrigir problemas de login múltiplo, tente uma destas soluções:

  • Saia de todas as suas Contas do Google e faça login apenas na conta que tem o projeto do Apps Script, o complemento ou o app da Web que você precisa 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 projeto do Apps Script, o complemento ou o app da Web que você precisa acessar.