Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Macro Converter é um complemento que facilita a conversão de arquivos do Excel
com código Visual Basic for Applications (VBA) em arquivos do Planilhas Google e
do Apps Script. Use o complemento Macro Converter para determinar a compatibilidade dos seus arquivos e convertê-los automaticamente.
Antes de começar
Para usar o Macro Converter:
Você precisa ter uma conta do Google Workspace Enterprise Plus ou do Google Workspace for Education Plus.
É necessário ter alguma experiência com o Excel ou as Planilhas Google e linguagens de programação (VBA ou Apps Script).
Você precisa saber ler e entender scripts básicos.
No canto superior direito, clique em Instalar > Continuar > Permitir.
A instalação pode levar alguns segundos. Depois que o complemento for instalado, clique em
Concluído.
Depois de instalado, o complemento Macro Converter fica no painel à direita do Google Drive. Se o painel lateral não aparecer, clique em Mostrar painel lateral chevron_left no canto inferior direito.
Atualize seu código VBA usando as informações do relatório de compatibilidade.
Se o código for totalmente compatível, talvez não seja necessário fazer mudanças.
Se o código VBA tiver APIs que não podem ser convertidas facilmente para o Apps Script,
o relatório oferece soluções alternativas no Apps Script. É possível implementar as soluções alternativas do Apps Script depois de converter os arquivos, mas se você tiver mais familiaridade com o VBA, talvez queira criar e implementar soluções alternativas em VBA antes da conversão.
Depois de fazer mudanças no código VBA, execute o relatório de compatibilidade novamente.
Essa etapa ajuda a confirmar o aumento da compatibilidade dos seus arquivos e sinaliza
outras atualizações que precisam ser feitas.
Repita as etapas 2 e 3 conforme necessário. Essas etapas maximizam a compatibilidade dos seus arquivos para reduzir a quantidade de trabalho necessária depois da conversão. Você
pode passar para a próxima etapa se planeja concluir a aplicação das soluções alternativas
depois de converter os arquivos.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThe Macro Converter add-on helps convert Excel files containing VBA code to Google Sheets with Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eIt requires a Google Workspace Enterprise Plus or Education Plus account and basic scripting knowledge.\u003c/p\u003e\n"],["\u003cp\u003eThe conversion process involves generating a compatibility report, updating VBA code based on the report, and then converting the files.\u003c/p\u003e\n"],["\u003cp\u003eUsers may need to address errors and common issues after conversion to ensure functionality in Google Sheets.\u003c/p\u003e\n"],["\u003cp\u003eDetailed guides and tutorials are available for compatibility checks, conversion steps, error fixing, and addressing common issues.\u003c/p\u003e\n"]]],[],null,["# Macro Converter add-on overview\n\nThe Macro Converter is an add-on that makes it easier to convert Excel files\nthat have Visual Basic for Applications (VBA) code to Google Sheets files and\nApps Script. You can use the Macro Converter add-on to determine the\ncompatibility of your files and automatically convert them.\n| **Note:** You can only use the Macro Converter add-on with Excel files. We support file formats from Excel 97 and above.\n\nBefore you begin\n----------------\n\nTo use the Macro Converter:\n\n- You must have a Google Workspace Enterprise Plus account or a Google Workspace for Education Plus account.\n- You should have some proficiency with Excel or Google Sheets and scripting languages (VBA or Apps Script).\n- You should be able to read and understand basic scripts.\n\nInstall the Macro Converter add-on\n----------------------------------\n\n1. On your computer, go to the [Macro Converter add-on on Google Workspace Marketplace](https://gsuite.google.com/marketplace/app/converter_alpha/383201976440).\n2. At the top right, click **Install** \\\u003e **Continue** \\\u003e **Allow**.\n3. Installation might take several seconds. Once the add-on is installed, click **Done**.\n\n| **Note:** If you're a Google Workspace administrator, you can install the Macro Converter add-on in your organization's domain and choose who can use the app. See [Install Google Workspace Marketplace apps in your domain](https://support.google.com/a/answer/172482).\n\nOnce installed, you can find the Macro Converter add-on in [Google Drive](https://drive.google.com/drive/my-drive), on the right side panel. If you don't see the side panel, at\nthe bottom right, click Show side panel chevron_left.\n\nHow to use the Macro Converter\n------------------------------\n\n1. **Generate a compatibility report for the files you want to convert** . See [Determine if VBA macros are compatible with Apps Script](/apps-script/guides/macro-converter/compatibility-report).\n2. **Update your VBA code using the information from your compatibility report** .\n 1. If your code is fully compatible, you might not need to make changes.\n 2. If your VBA code has APIs that won't easily convert to Apps Script code, the report offers workarounds in Apps Script. You can implement the Apps Script workarounds after you convert your files, but if you're more familiar with VBA you might want to create and implement VBA workarounds before you convert your files.\n3. **After you make changes to your VBA code, run the compatibility report again**. This step helps confirm the increased compatibility of your files and flags any additional updates that should be made.\n4. **Repeat steps 2 and 3 as needed**. These steps maximize the compatibility of your files to reduce the amount of work needed after you convert them. You can proceed to the next step if you plan to finish applying your workarounds after you convert your files.\n5. [**Convert your files**](/apps-script/guides/macro-converter/convert-files).\n6. [**Fix errors**](/apps-script/guides/macro-converter/fix-conversion-errors). You might need to make adjustments to your new Apps Script code to make sure your code works as intended.\n7. [**Address common issues**](/apps-script/guides/macro-converter/address-conversion-issues). You might need to manually create items, like VBA UserForms, in Apps Script.\n\nRelated articles\n----------------\n\n- [Determine if VBA macros are compatible](/apps-script/guides/macro-converter/compatibility-report)\n- [Convert VBA macros to Apps Script](/apps-script/guides/macro-converter/convert-files)\n- [Fix errors in your converted code](/apps-script/guides/macro-converter/fix-conversion-errors)\n- [Address common issues](/apps-script/guides/macro-converter/address-conversion-issues)\n- [Watch Macro Converter tutorials](/apps-script/guides/macro-converter/tutorials)\n- [List of compatible VBA APIs](/apps-script/guides/macro-converter/compatible-vba-apis)"]]
