Esta página lista as principais mudanças em cada versão do Google Apps Script em 2020. Seu objetivo é ajudar os desenvolvedores a identificar as mudanças de comportamento. Para ver alterações mais recentes, consulte as notas da versão do ano atual.
Dezembro de 2020
7 de dezembro de 2020
O ambiente de desenvolvimento integrado do Apps Script, ou IDE, foi totalmente reprojetado. Além de uma interface totalmente nova, os seguintes recursos foram atualizados:
- O editor agora tem uma barra lateral à esquerda recolhível para navegar até a visão geral, as configurações, as execuções e os acionadores do projeto do Apps Script.
- O painel de recursos do editor agora inclui arquivos, serviços avançados e bibliotecas.
- A formatação automática foi adicionada ao editor.
- O preenchimento automático do editor foi aprimorado para ser mais rápido, mais consistente e estende o suporte para funções definidas pelo usuário e recursos da linguagem JavaScript. Você pode adicionar o JSDoc às suas funções para sugestões melhores de preenchimento automático.
- O editor agora é compatível com o bloqueio de códigos e o fechamento de funções.
- Um atalho do teclado e uma paleta de comandos foram adicionados ao editor. Pressione F1 para ver a paleta de comandos e os atalhos de teclado disponíveis.
- O editor agora inclui um menu contextual de clique com o botão direito do mouse com opções como "Go to To", "Rename Symbols" e "Command Palette".
- Melhorias foram feitas no desempenho e na velocidade do depurador.
- Os registros agora são transmitidos em tempo real à medida que você executa um script.
- A caixa de diálogo de implantações detecta automaticamente os tipos de implantação no manifesto do projeto do script. Você pode mudar ou adicionar mais tipos, conforme necessário.
- As implantações foram mescladas com versões. Sempre que você cria uma nova implantação, uma nova versão é criada automaticamente. Os usuários de
clasp
não são afetados por essa mudança. - Uma única implantação pode ser um complemento de complemento, um app da Web, uma biblioteca ou um executável de API. Qualquer implantação pode ser usada como uma biblioteca.
- Agora, apenas uma implantação pode estar ativa por vez. Essa mudança não afeta
as implantações ativas atuais.
clasp
usuário não foi afetado por essa mudança. - Não é mais possível desativar explicitamente os apps da Web publicados. Em vez disso, exclua a implantação que tem o app da Web. Para reativá-lo, implante-o novamente.
- O depurador não é mais compatível com o ambiente de execução do Rhino. Para usar o depurador, migre seu script para o ambiente de execução V8.
- Ainda não há suporte para os complementos do editor de testes nesta versão e eles serão adicionados em 2021. Para testar os complementos do editor, volte para o ambiente de desenvolvimento integrado legado.
Para voltar ao ambiente de desenvolvimento integrado legado no editor, clique em Usar editor legado na parte superior.
Outubro de 2020
23 de outubro de 2020
Um serviço avançado para o Google Tables foi adicionado ao Apps Script. Com o serviço de tabelas, os scripts podem ler e editar linhas de maneira programática no Tables.
Setembro de 2020
3 de setembro de 2020
Novas classes e métodos foram adicionados para serem compatíveis com as páginas conectadas.
As novas classes a seguir foram adicionadas ao serviço Planilhas:
DataSourceChart
DataSourceColumn
DataSourceFormula
DataSourcePivotTable
DataSourceRefreshSchedule
DataSourceRefreshScheduleFrequency
DataSourceSheet
DataSourceSheetFilter
DataSourceTableColumn
DataSourceTableFilter
DateTimeGroupingRule
PivotGroupLimit
SortSpec
Novos métodos para oferecer suporte ao páginas conectadas foram adicionados às seguintes classes no serviço Planilhas:
BigQueryDataSourceSpecBuilder
BigQueryDataSourceSpec
DataExecutionStatus
DataSourceTable
DataSource
EmbeddedChart
FilterCriteriaBuilder
PivotFilter
PivotGroup
PivotTable
PivotValue
Range
Sheet
SpreadsheetApp
Spreadsheet
Agosto de 2020
27 de agosto de 2020
Uma nova classe chamada DecoratedText
foi adicionada ao Serviço de cartão. DecoratedText
adiciona texto
com decorações opcionais e foi adicionado para substituir a classe
KeyValue
.
Julho de 2020
27 de julho de 2020
Para ajudar a simplificar a estrutura de pastas e os modelos de compartilhamento do Google Drive, novos métodos foram adicionados ao serviço do Drive e alguns métodos existentes foram descontinuados.
O DriveApp
agora tem um método
enforceSingleParent(value)
que ativa ou desativa o comportamento de enforceSingleParent
.
A classe File
agora tem os seguintes
métodos:
file.getTargetId()
: recebe um ID de arquivo de atalho.file.getTargetMimeType()
: retorna o tipo MIME do item que um atalho aponta.file.moveTo(destination)
: move um arquivo para uma pasta de destino especificada.
A classe Folder
agora tem os seguintes
métodos:
folder.createShortcut(targetId)
: cria um atalho para o código do item do Drive informado e o retorna.folder.moveTo(destination)
: move um item para a pasta de destino fornecida.
Os seguintes métodos da classe Folder
foram descontinuados:
addFile(File)
addFolder(Folder)
removeFile(File)
removeFolder(Folder)
Junho de 2020
12 de junho de 2020
Novos métodos foram adicionados ao serviço Planilhas.
- A classe
RichTextValue
agora tem um métodoRichTextValue.getLinkUrl()
que busca o URL do valor especificado. - A classe
RichTextValueBuilder
agora tem um métodoRichTextValueBuilder.setLinkUrl()
que define o URL do link para o valor especificado. - A classe
PivotTable
agora tem um métodoPivotTable.getSourceDataRange()
que retorna o intervalo de dados de origem em que a tabela dinâmica é construída. - A classe
PivotValue
agora tem um métodoPivotValue.remove()
que remove o valor da tabela dinâmica.
Abril de 2020
22 de abril de 2020
Um novo acionador simples, onSelectionChange(e)
,
foi adicionado ao Planilhas Google. O gatilho onSelectionChange(e)
é executado
automaticamente quando um usuário muda a seleção em uma planilha.
2 de abril de 2020
As informações a seguir foram adicionadas ao Serviço de planilha.
- Uma nova classe Desenho foi adicionada para oferecer suporte a desenhos.
- Agora você pode acessar seus desenhos com o método
Sheet.getDrawings()
.
Os itens a seguir foram adicionados ao serviço do Drive:
- Há um novo valor de
FILE_ORGANIZER
na enumeração de permissão. Se você tiver a permissãoFILE_ORGANIZER
em um drive compartilhado, poderá editar, enviar para a lixeira e mover o conteúdo desse drive.
Fevereiro de 2020
28 de fevereiro de 2020
Os métodos a seguir foram adicionados ao
serviço da Planilhas
para oferecer compatibilidade com o uso de cores do tema. Muitos desses métodos duplicam o
efeito dos métodos de cores existentes, mas permitem que você use
objetos Color
em vez de strings
como parâmetros e tipos de retorno:
- A classe
Banding
agora tem 16 novos métodos que manipulam cores nas colunas e linhas de banda usando objetosColor
. - A classe
BooleanCondition
agora tem dois novos métodos que recuperam a cor do plano de fundo e da fonte da condição como objetosColor
. - A classe
ConditionalFormatRuleBuilder
agora tem sete novos métodos que definem regras de formato baseadas em cores usando objetosColor
. - A classe
GradientCondition
agora tem três novos métodos que recuperam cores de condição como objetosColor
. - A classe
Range
agora tem oito novos métodos que recebem e definem cores de fonte e de plano de fundo usando objetosColor
. - A classe
Sheet
agora tem dois novos métodos que recebem e definem cores de guia usando objetosColor
. - A classe
Slicer
agora tem dois novos métodos que recebem e definem a cor do plano de fundo do controle de filtros usando objetosColor
. - A classe
TextStyleBuilder
agora tem um métodoTextStyleBuilder.setForegroundColorObject(color)
que atualiza a cor do primeiro plano do builder de estilo usando um objetoColor
. - A classe
TextStyle
agora tem um métodoTextStyle.getForegroundColorObject()
que recebe a cor do primeiro plano do estilo como um objetoColor
.
5 de fevereiro de 2020
O Apps Script agora é compatível com o ambiente de execução V8. Isso ativa a sintaxe e os recursos modernos do JavaScript no Apps Script. É possível migrar os scripts atuais para usar o V8 e os recursos dele.
Janeiro de 2020
21 de janeiro de 2020
Para oferecer suporte ao lançamento dos Complementos do G Suite, estas alterações de manifesto, serviço, classes e métodos foram adicionados ao Apps Script:
A estrutura do manifesto do Apps Script foi atualizada para fornecer controles de configuração para os Complementos do G Suite. Todas as configurações do manifesto de complementos são especificadas no objeto
AddOns
no manifesto.Os campos de manifesto que anteriormente aceitavam complementos do Gmail ainda existem, mas foram descontinuados. Consulte Fazer upgrade dos complementos publicados para saber como fazer upgrade de um complemento do Gmail para um complemento do G Suite.
O serviço de Card foi estendido com as seguintes classes e métodos que fornecem novos widgets e respostas de evento:
CalendarEventActionResponse
CalendarEventActionResponseBuilder
DatePicker
DateTimePicker
DisplayStyle
DriveItemsSelectedActionResponse
DriveItemsSelectedActionResponseBuilder
FixedFooter
SwitchControlType
TimePicker
CardBuilder.setDisplayStyle(displayStyle)
CardBuilder.setFixedFooter(fixedFooter)
CardBUilder.setPeekCardHeader(peekCardHeader)
CardService.newCalendarEventActionResponseBuilder()
CardService.newDatePicker()
CardService.newDateTimePicker()
CardService.newDriveItemsSelectedActionResponseBuilder()
CardService.newFixedFooter()
CardService.newTimePicker()
Switch.setControlType(controlType)
O serviço de dados de videoconferência foi adicionado ao Apps Script. O serviço ajuda os Complementos do G Suite que estendem o Google Agenda para permanecer em sincronia com aplicativos de videoconferência de terceiros. Esse serviço é útil apenas para desenvolvedores que gerenciam um aplicativo de videoconferência e querem disponibilizá-lo no Google Agenda.