最初に、「マクロとは? それを使用する理由とは?」という疑問にお答えします。マクロとは、それぞれのタスクを自動化することによって、時間を節約できるように設計されたプログラムです。各マクロは、一連の定義済み手順を実行することで、特定のタスクを実行します。その手順は繰り返し可能である必要があり、そのアクションは予測可能である必要があります。
たとえば、プロジェクトにグリッドを追加したり、選択したオブジェクトを回転したり、または構造内のすべての部屋の平方フィート長に関する情報を収集する目的で、マクロを定義できます。一般例としては他に、次があります。
- Revit コンテンツを外部ファイルに配置して抽出する
- ジオメトリまたはパラメータを調整する
- 数多くのタイプの要素を作成する
- 外部ファイル形式の読み込みや書き出しを行う
Revit には、プロジェクトの機能を拡張可能にするアプリケーション プログラミング インタフェース(API)が付属しています。[アドイン]タブ 
[外部ツール]パネルにカスタマイズしたコマンドを追加したり、新しいパネルやツールを追加することができます。
これらの API 拡張に加えて、API を使用して Revit で動作するマクロを定義できます。このトピックの後半で API の違いについて説明しますが、熟練した開発者にとっては、Revit.ini にマクロを登録したり、参照として RevitAPI.dll を追加する必要がないことに注目してください。
API 変更の想定
Revit API は以後の製品リリースで変更される可能性が非常に高いです。つまり、次のリリースの Revit をインストールした後には、API 変更を反映するためのマクロを編集して再構築する必要が生じます。