Cómo determinar si las macros de VBA son compatibles
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Un archivo de Excel con macros de Visual Basic para aplicaciones (VBA) se considera compatible si todas las APIs que se usan en las macros tienen un equivalente directo en Apps Script. Si tus macros no son totalmente compatibles, es posible que puedas aplicar soluciones alternativas o ajustar el código para que funcionen con Apps Script.
Usa el informe de compatibilidad de Macro Converter para determinar si puedes convertir automáticamente tus archivos tal como están o si necesitas realizar ajustes en tu código.
Cuando generas un informe de compatibilidad, se aplica uno de los siguientes estados a cada uno de tus archivos y APIs:
Estado
Definición
Compatible exactamente
Estos archivos contienen APIs que tienen equivalentes directos en Apps Script.
Compatible con soluciones alternativas
Estos archivos contienen al menos una API que se puede admitir con una solución alternativa.
Requiere más investigación
Estos archivos contienen al menos una API que debes revisar para
determinar cómo proceder. Por ejemplo, es posible que no haya una API equivalente o que el Convertidor de macros no haya determinado la API en uso.
En el panel lateral derecho, haz clic en el complemento Macro Converter .
Si no ves el panel lateral, haz clic en Mostrar panel lateral chevron_left en la esquina inferior derecha.
Haz clic en Agregar archivos y carpetas. Macro Converter solo reconoce archivos de Excel.
Elige los archivos o las carpetas que quieras analizar y haz clic en Seleccionar. Selecciona menos de 2,000 archivos a la vez.
Para cambiar la ubicación en la que se guarda el informe de compatibilidad, haz clic en Cambiar carpeta de destino edit y selecciona la carpeta que desees. De lo contrario, se guardará en la carpeta Mi unidad.
Haz clic en Generar informe.
Cuando se complete el análisis, haz clic en Ver informe.
Revisa el informe de compatibilidad
Usa los detalles del informe de compatibilidad para decidir cómo continuar con la conversión del archivo. Tu informe incluye las siguientes secciones:
Resumen: En esta hoja, se proporciona un análisis agregado de la compatibilidad de todos los archivos enviados y sus APIs.
Files - compatibility: En esta hoja, se enumeran todos los archivos enviados a Macro Converter con el estado de compatibilidad y los detalles de cada archivo.
Files - detailed analysis: Esta hoja proporciona más información sobre las APIs dentro de un archivo y las acciones que puedes realizar para convertir correctamente cada API. Primero, en el menú desplegable superior, selecciona un archivo. Luego, en el menú desplegable de la parte inferior, selecciona un estado.
También puedes revisar el informe API por API con las hojas llamadas APIs to investigate y APIs with workarounds.
Determina cómo proceder
A continuación, te indicamos lo que recomendamos para cada estado:
Debes escribir código para reemplazar al menos una API de VBA por la API de Apps Script equivalente. En general, puedes continuar con la conversión.
Puedes reemplazar manualmente las APIs de VBA marcadas como Compatibles con soluciones alternativas antes o después de convertir el archivo. Te recomendamos que realices los cambios con anticipación.
Requiere más investigación
No se puede convertir al menos una API. Según la importancia de esa API en tu código, es posible que no puedas convertir el archivo.
Alguien que comprenda el código VBA original debe realizar la evaluación final.
Si decides convertir tu archivo, debes escribir código para reemplazar al menos una API de VBA por Apps Script. Puedes reemplazar manualmente las APIs de VBA marcadas como Necesita investigación antes o después de convertir el archivo. Te recomendamos que realices los cambios con anticipación.
[null,null,["Última actualización: 2025-08-31 (UTC)"],[[["\u003cp\u003eVBA macros with direct Apps Script equivalents are considered compatible and can be automatically converted using the Macro Converter add-on.\u003c/p\u003e\n"],["\u003cp\u003eThe Macro Converter's compatibility report identifies files as "Supported exactly", "Supported with workarounds", or "Needs more investigation", guiding your conversion strategy.\u003c/p\u003e\n"],["\u003cp\u003eFor files needing workarounds or further investigation, manual code adjustments may be necessary before or after conversion using equivalent Apps Script APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe compatibility report provides detailed analysis at the file and API level to help assess conversion feasibility and required actions.\u003c/p\u003e\n"],["\u003cp\u003eAfter reviewing the report, proceed with file conversion, addressing potential issues as outlined in the documentation.\u003c/p\u003e\n"]]],[],null,["# Determine if VBA macros are compatible\n\nAn Excel file with Visual Basic for Applications (VBA) macros is considered\ncompatible if all APIs used in the macros have a direct equivalent in Apps\nScript. If your macros aren't fully compatible, you might be able to apply\nworkarounds or adjust the code to make them work with Apps Script.\n\nUse the Macro Converter's compatibility report to determine if you can\nautomatically convert your files as-is or if you need to make adjustments to\nyour code.\n\nWhen you generate a compatibility report, one of the following statuses is\napplied to each of your files and APIs:\n\n| Status | Definition |\n|--------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | These files contain APIs that all have direct equivalents in Apps Script. |\n| **Supported with workarounds** | These files contain at least one API that can be supported with a workaround. |\n| **Needs more investigation** | These files contain at least one API that you need to review to determine how to proceed. For instance, there might not be an equivalent API, or the Macro Converter might not have determined the API in use. |\n\nGenerate a compatibility report\n-------------------------------\n\n1. On your computer, open [Google Drive](https://drive.google.com/drive/my-drive).\n2. On the right side panel, click the Macro Converter add-on . If you don't see the side panel, at the bottom right, click Show side panel chevron_left.\n3. Click **Add files and folders**. The Macro Converter only recognizes Excel files.\n4. Choose the files or folders you want to analyze and click **Select**. Select fewer than 2,000 files at a time.\n5. To change where your compatibility report is saved, click Change destination folder edit, and select the folder you want. Otherwise, it's saved in your MyDrive folder.\n6. Click **Generate report**.\n7. When the analysis completes, click **View report**.\n\nReview the compatibility report\n-------------------------------\n\nUse the details in the compatibility report to help you decide how to proceed\nwith your file conversion. Your report includes the following sections:\n\n- **Summary**: This sheet gives an aggregated analysis of the compatibility of all submitted files and their APIs.\n- **Files - compatibility**: This sheet lists every file submitted to the Macro Converter with the compatibility status and details of each file.\n- **Files - detailed analysis**: This sheet gives more information about the\n APIs within a file and what actions you can take to successfully convert each\n API. First, from the top dropdown menu, select a file. Then, from the bottom\n dropdown menu, select a status.\n\n | **Note:** If multiple files have the same name, next to the file names, use the unique identifiers to tell the difference between them. You can open the files in Drive and look for the unique identifiers in the URLs: `https://drive.google.com/file/d/\u003cfile_identifier\u003e/view`.\n\nYou can also review the report on an API-by-API basis using the sheets called\n**APIs to investigate** and **APIs with workarounds**.\n\nDetermine how to proceed\n------------------------\n\nHere's what we recommend for each status:\n\n| Status | Recommendation |\n|--------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Supported exactly** | The same logic from your VBA APIs will be replicable in Apps Script. [Proceed with the conversion](/apps-script/guides/macro-converter/convert-files). |\n| **Supported with workarounds** | You need to write code to replace at least one VBA API with the equivalent Apps Script API. In general, you can proceed with the conversion. You can manually replace the VBA APIs marked as *Supported with workarounds* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n| **Needs more investigation** | At least one API can't be converted. Depending on the importance of that API in your code, you might not be able to convert the file. Someone who understands the original VBA code should do the final evaluation. \u003cbr /\u003e If you decide to convert your file, you need to write code to replace at least one VBA API with Apps Script. You can manually replace the VBA APIs marked as *Needs investigation* either before or after you convert the file. We recommend that you [make your changes beforehand](/apps-script/guides/macro-converter/convert-files#modify_incompatible_vba_apis). |\n\nAfter you assess your compatibility report, see [Convert VBA macros to Apps\nScript](/apps-script/guides/macro-converter/convert-files).\n\nRelated articles\n----------------\n\n- [Macro Converter add-on overview](/apps-script/guides/macro-converter/overview)\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)"]]
.
Si no ves el panel lateral, haz clic en Mostrar panel lateral en la esquina inferior derecha.