Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Uma versão é uma cópia estática de um script. Com as versões, você acompanha suas
mudanças. Depois de salvar uma versão, não é possível modificá-la. Use versões quando estiver
trabalhando em um script que passa por muitas mudanças e iterações. Os projetos de script podem ter até 200 versões.
É necessário criar versões ao escrever uma biblioteca. Para mais informações, consulte Bibliotecas.
Criar uma versão
Uma versão é criada automaticamente quando você cria uma implantação. Você também pode criar uma nova versão de uma implantação atual seguindo estas etapas:
Abra seu projeto de script.
Na parte de cima, clique em Implantar>Gerenciar implantações.
Selecione a implantação ativa para criar uma nova versão e clique em
Editar edit.
Na seção Versão, selecione Nova versão.
Clique em Implantar.
Acessar uma versão anterior
Para ver uma versão criada anteriormente no projeto de script, siga estas etapas:
No projeto de script, clique em historyHistórico do projeto.
Em Histórico do projeto, selecione a versão que você quer acessar. Para ver a descrição de uma versão, mantenha o ponteiro do mouse sobre o número dela.
Comparar uma versão anterior com a atual
Para comparar uma versão criada anteriormente com a atual, ou principal, siga estas etapas:
No projeto de script, clique em historyHistórico do projeto.
Em Histórico do projeto, selecione a versão que você quer acessar.
Ative a opção Destacar mudanças.
Dependendo das mudanças feitas desde a versão selecionada, a lista de arquivos
pode conter os seguintes marcadores:
Marcador
Tipo de mudança
Descrição
Arquivo adicionado
Este arquivo é novo na versão atual.
Arquivo excluído
Este arquivo não está mais presente na versão atual.
Arquivo modificado
Este arquivo tem mudanças na versão atual que não estavam presentes na versão selecionada. Para ver as mudanças, clique no nome do arquivo.
Restaurar uma versão
No projeto de script, clique em historyHistórico do projeto.
Ao lado da versão que você quer restaurar, clique em
more_vertMais ações>Restaurar esta versão>Restaurar.
Excluir versões
É possível excluir permanentemente
versões se elas não estiverem sendo usadas por uma implantação ativa. Para arquivar uma implantação
ou mudar a versão usada por uma implantação ativa,
consulte Criar e gerenciar implantações.
Excluir uma versão
Para excluir uma versão por vez, siga estas etapas:
No projeto de script, clique em historyHistórico do projeto.
Ao lado da versão que você quer excluir, clique em
more_vertMais ações>Excluir esta versão>Excluir.
Excluir várias versões de uma vez
Para excluir várias versões ao mesmo tempo, siga estas etapas:
No projeto de script, clique em historyHistórico do projeto.
Clique em Excluir versões em massa. Uma caixa de diálogo mostra uma lista de versões que podem ser excluídas. As versões em uso por uma implantação ativa não são incluídas na lista.
Selecione as versões que você quer excluir e clique em Excluir.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eVersions in Apps Script are static copies of your script, allowing you to track changes and revert to previous states if necessary.\u003c/p\u003e\n"],["\u003cp\u003eCreating versions is essential for libraries and projects undergoing frequent modifications, providing a history of your script's development.\u003c/p\u003e\n"],["\u003cp\u003eYou can easily create, view, compare, and delete versions within your Apps Script project using the provided steps.\u003c/p\u003e\n"],["\u003cp\u003eA maximum of 200 versions can be stored per script project, offering ample space for tracking your progress.\u003c/p\u003e\n"],["\u003cp\u003eVersions in use by active deployments cannot be deleted, ensuring that your deployed scripts remain functional.\u003c/p\u003e\n"]]],[],null,["# Versions\n\nA version is a static copy of a script. Versions let you track your\nchanges. Once you save a version, you can't modify it. Use versions when you're\nworking on a script that goes through many changes and iterations. Script\nprojects can have up to 200 versions.\n\nCreating versions is required when you're writing a library. For more\ninformation, see [Libraries](https://developers.google.com/apps-script/guides/libraries.html#creating-a-library).\n\nCreate a version\n----------------\n\nA version is automatically created when you create a new deployment. You can\nalso create a new version from an existing deployment by taking the following\nsteps:\n\n1. Open your script project.\n2. At the top, click **Deploy** \\\u003e **Manage\n deployments**.\n3. Select the active deployment to create a new version for and click Edit edit.\n4. In the **Version** section, select **New version**.\n5. Click **Deploy**.\n\nView a previous version\n-----------------------\n\nTo view a previously created version within your script project, take the\nfollowing steps:\n\n1. In your script project, click history **Project History**.\n2. Under **Project history**, select the version you want to view. To view the description of a version, hold the pointer over the version number.\n\nCompare a previous version to the current version\n-------------------------------------------------\n\nTo compare a previously created version to the current, or head, version, take\nthe following steps:\n\n1. In your script project, click history **Project History**.\n2. Under **Project history**, select the version you want to view.\n3. Turn on **Highlight changes**.\n\nDepending on the changes you've made since the selected version, the files list\nmight contain the following markers:\n\n| Marker | Type of change | Description |\n|--------|----------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| | File added | This file is new in the current version. |\n| | File deleted | This file is no longer present in the current version. |\n| | File modified | This file has changes in the current version that weren't present in the selected version. To view the changes, click the file name. |\n\nRestore a version\n-----------------\n\n1. In your script project, click history **Project History**.\n2. Next to the version you want to restore, click more_vert **More actions** \\\u003e **Restore this version** \\\u003e **Restore**.\n\nDelete versions\n---------------\n\nYou can permanently delete\nversions if they're not in use by an active deployment. To archive a deployment\nor change the version that an active deployment uses,\nrefer to [Create and manage deployments](/apps-script/concepts/deployments).\n\n### Delete a version\n\nTo delete one version at a time, take the following steps:\n\n1. In your script project, click history **Project History**.\n2. Next to the version you want to delete, click more_vert **More actions** \\\u003e **Delete this version** \\\u003e **Delete**.\n\n### Delete multiple versions at once\n\nTo delete multiple versions at the same time, take the following steps:\n\n1. In your script project, click history **Project History**.\n2. Click **Bulk delete versions**. A dialog shows a list of versions that you can delete. Versions in use by an active deployment aren't included in the list.\n3. Select the versions to delete and click **Delete**.\n4. In the dialog, click **Delete**."]]
Excluir versões em massa. Uma caixa de diálogo mostra uma lista de versões que podem ser excluídas. As versões em uso por uma implantação ativa não são incluídas na lista.