VBA マクロに互換性があるかどうかを確認する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Visual Basic for Applications（VBA）マクロを含む Excel ファイルは、マクロで使用されているすべての API に Apps Script で直接同等のものがある場合に互換性があると見なされます。マクロに完全な互換性がない場合は、回避策を適用するか、コードを調整して Apps Script で動作するようにできる可能性があります。
Macro Converter の互換性レポートを使用して、ファイルをそのまま自動的に変換できるかどうか、またはコードを調整する必要があるかどうかを確認します。
互換性レポートを生成すると、各ファイルと API に次のいずれかのステータスが適用されます。
| ステータス |
定義 |
| 完全にサポートされている |
これらのファイルには、Apps Script に直接対応する API が含まれています。 |
| 回避策でサポート |
これらのファイルには、回避策でサポートできる API が 1 つ以上含まれています。 |
| 追加の調査が必要 |
これらのファイルには、続行方法を判断するために確認する必要がある API が少なくとも 1 つ含まれています。たとえば、同等の API が存在しない場合や、マクロ コンバータが使用中の API を特定できなかった場合などです。 |
互換性レポートを生成する
- パソコンで Google ドライブを開きます。
- 右側のパネルで、マクロ コンバータ アドオン
をクリックします。サイドパネルが表示されていない場合は、右下の「サイドパネルを表示」アイコン chevron_left をクリックします。
- [ファイルとフォルダを追加] をクリックします。Macro Converter は Excel ファイルのみを認識します。
- 分析するファイルまたはフォルダを選択して、[選択] をクリックします。一度に選択するファイル数は 2,000 個未満にしてください。
- 互換性レポートの保存先を変更するには、[保存先フォルダを変更] edit をクリックし、目的のフォルダを選択します。それ以外の場合は、マイドライブ フォルダに保存されます。
- [レポートを生成] をクリックします。
- 分析が完了したら、[レポートを表示] をクリックします。
互換性レポートを確認する
互換性レポートの詳細を使用して、ファイルの変換をどのように進めるかを判断します。レポートには次のセクションが含まれます。
また、[APIs to investigate]（調査対象の API）シートと [APIs with workarounds]（回避策のある API）シートを使用して、API ごとにレポートを確認することもできます。
対応方法を決定する
各ステータスにおすすめの対応は次のとおりです。
| ステータス |
推奨事項 |
| 完全にサポートされている |
VBA API の同じロジックを Apps Script で複製できます。変換を続行します。 |
| 回避策でサポート |
少なくとも 1 つの VBA API を同等の Apps Script API に置き換えるコードを記述する必要があります。通常は、変換を続行できます。
回避策でサポートされているとマークされた VBA API は、ファイルの変換前または変換後に手動で置き換えることができます。事前に変更を行うことをおすすめします。 |
| 追加の調査が必要 |
少なくとも 1 つの API を変換できません。コード内の API の重要度によっては、ファイルを変換できない場合があります。元の VBA コードを理解している人が最終評価を行う必要があります。
ファイルを変換する場合は、少なくとも 1 つの VBA API を Apps Script に置き換えるコードを記述する必要があります。調査が必要とマークされた VBA API は、ファイルの変換前または変換後に手動で置き換えることができます。事前に変更を行うことをおすすめします。 |
互換性レポートを評価したら、VBA マクロを Apps Script に変換するをご覧ください。
関連記事
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-31 UTC。
[null,null,["最終更新日 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)"]]
