Esta página lista as principais mudanças em cada versão do Google Apps Script em 2022. O objetivo é ajudar os desenvolvedores a identificar mudanças recentes no comportamento. Para alterações mais antigas, consulte as notas de versão de 2021, 2020, 2019, 2018, 2017, 2016, 2015, 2014, .
Dezembro de 2022
16 de dezembro de 2022
O Apps Script suspendeu o uso do serviço Contatos. Em vez disso, use o serviço avançado da API People. Consulte Migrar do serviço Contatos para o serviço avançado da API People.
O Apps Script vai ser desativado em abril de 2023. Consulte a programação da desativação do Apps Script.
Novembro de 2022
3 de novembro de 2022
O Apps Script adicionou um novo método à classe Utilities.
parseDate(date, timeZone, format)
analisa uma data de string fornecida de acordo com a especificação descrita na
classe SimpleDateFormat do Java Standard Edition.
1º de novembro de 2022
O Apps Script suspendeu o uso dos seguintes métodos:
Não há um método de substituição para conseguir esses dados com o Apps Script.
Saiba mais sobre a mudança do Hangouts clássico para o Chat
Setembro de 2022
27 de setembro de 2022
O Apps Script desativou o ambiente de desenvolvimento integrado legado (IDE, na sigla em inglês) em favor do ambiente de desenvolvimento integrado reformulado, lançado em dezembro de 2020.
Saiba mais sobre as atualizações do IDE nestas postagens do blog:
- O ambiente de desenvolvimento integrado do Apps Script atualizado vai substituir a experiência legada até o quarto trimestre de 2022
- Funcionalidade adicional para o editor de scripts do ambiente de desenvolvimento integrado (IDE, na sigla em inglês) do Apps Script
- Use o novo editor de scripts do ambiente de desenvolvimento integrado do Apps Script
Julho de 2022
19 de julho de 2022
O Apps Script agora exclui automaticamente projetos padrão do Google Cloud (projetos do Google Cloud criados pelo Apps Script em segundo plano) quando os scripts associados não são executados em 180 dias ou mais. Se o script for executado depois que o Apps Script excluir o projeto padrão do Google Cloud, ele criará um para o script.
Essa atualização não afeta projetos padrão do Google Cloud (projetos do Google Cloud criados por pessoas).
8 de julho de 2022
O Google Script suspendeu o uso dos seguintes métodos:
Esses métodos ficarão indisponíveis ainda este ano, quando o Google migrar todos os usuários do Hangouts clássico para o Google Chat. Não há um método de substituição para conseguir esses dados com o Apps Script.
Saiba mais sobre a mudança do Hangouts clássico para o Chat
Junho de 2022
6 de junho de 2022
Agora é possível chamar funções em arquivos separados antes de serem analisadas. Anteriormente, o tempo de execução do V8 exigia que um arquivo de script fosse analisado antes que qualquer outro arquivo pudesse chamar as funções que ele define.
Agora, a ordem dos arquivos no editor do Apps Script não importa. Isso significa que é possível chamar uma função em um arquivo diferente para atribuir um valor a uma variável global. A função é sempre definida antes de ser chamada. Esse comportamento reflete o do ambiente de execução legado do Rhino.
Neste exemplo, um erro costumava ocorrer se o arquivo de script First.gs
fosse analisado antes do arquivo de script Second.gs
:
Primeiro.gs// This no longer fails in V8 if Second.gs isn't // parsed by the time First.gs is // being parsed. var globalVar = calculate(); function myFunction() { Logger.log("globalVar = %s", globalVar); } |
Segundos.gs// A utility function saved in a separate // file (Second.gs) in the same script // project. function calculate() { return Math.random(); } |
Abril de 2022
13 de abril de 2022
Agora é possível realizar as seguintes ações no novo ambiente de desenvolvimento integrado (IDE, na sigla em inglês) do Apps Script:
- Crie implantações de teste para complementos do Editor.
- Adicione, edite e exclua as propriedades do script na página de configurações do projeto.
- Classifique os arquivos em ordem alfabética no editor.
- Depurar funções do Rhino sem migrar para o ambiente de execução do V8. Se o código não for compatível com V8, você poderá receber erros.
- Defina o fuso horário de um projeto de script.
Março de 2022
24 de março de 2022
Para os complementos do Google Workspace, uma classe Attachment
foi adicionada ao Card Service
que permite adicionar anexos personalizados aos eventos do Agenda. Também é possível definir um acionador de evento que é acionado quando o usuário clica no provedor de anexos de complementos no menu suspenso do Agenda. Para mais informações, consulte EventAttachmentTrigger
.
18 de março de 2022
O uso dos métodos get
para vários objetos de cor no Serviço de planilhas foi suspenso e substituído por uma nova convenção de nomenclatura. A funcionalidade permanece a
mesma. Por exemplo, o método getFontColor()
da classe Range
foi substituído por getFontColorObject()
.
As seguintes classes atualizaram os métodos get
para objetos de cor:
Banding
getFirstColumnColor()
agora égetFirstColumnColorObject()
.getFirstRowColor()
agora égetFirstRowColorObject()
.getFooterColumnColor()
agora égetFooterColumnColor()
.getFooterRowColor()
agora égetFooterRowColorObject()
.getHeaderColumnColor()
agora égetHeaderColumnColorObject()
.getHeaderRowColor()
agora égetHeaderRowColorObject()
.getSecondColumnColor()
agora égetSecondColumnColorObject()
getSecondRowColor()
agora égetSecondRowColorObject()
.
BooleanCondition
getBackground()
agora égetBackgroundObject()
.getFontColor()
agora égetFontColorObject()
.
GradientCondition
getMaxColor()
agora égetMaxColorObject
.getMidColor()
agora égetMidColorObject
.getMinColor()
agora égetMinColorObject
.
Range
getFontColor()
agora égetFontColorObject()
.getFontColors()
agora égetFontColorObjects()
.
Sheet
getTabColor()
agora égetTabColorObject
.
Slicer
getBackgroundColor()
agora égetBackgroundColorObject()
.
Fevereiro de 2022
14 de fevereiro de 2022
Os proprietários recebem alertas por e-mail quando alguém de fora da organização edita um projeto de script no novo ambiente de desenvolvimento integrado (IDE, na sigla em inglês).
Para scripts vinculados a contêineres: se alguém fora da organização do proprietário do contêiner criar ou editar um projeto de script vinculado a esse contêiner, o proprietário do contêiner receberá uma notificação por e-mail.
Para scripts autônomos: se alguém fora da organização do proprietário do projeto de script editar um projeto de script autônomo, o proprietário do projeto de script receberá uma notificação por e-mail.
19 de janeiro de 2022
As seguintes classes foram adicionadas ao serviço de planilhas para permitir que você adicione imagens às células:
CellImageBuilder
: esse builder cria o valor de imagem necessário para adicionar uma imagem a uma célula.CellImage
: representa uma imagem a ser adicionada a uma célula.
Para adicionar uma imagem a uma célula, é preciso criar um novo valor para a imagem usando
SpreadsheetApp.newCellImage()
e CellImageBuilder
.
Em seguida, use Range.setValue(value)
ou Range.setValues(values)
para adicionar o valor da imagem à célula.