エディタ アドオンを作成する際の一般的な手順は次のとおりです。
- Apps Script プロジェクトを作成する。
- Apps Script に組み込まれている HTML サービスを使用して、アドオンの外観と動作を定義するコードを記述します。
- アドオンをテストします。
- アドオンを公開します。
スクリプト プロジェクトを作成する
エディタ アドオンは、スタンドアロンの Apps Script プロジェクトです。スタンドアロン スクリプト ガイドに、新しいプロジェクトを作成する手順が記載されています。新しいスクリプトを開くこともできます。この操作を行うと、プロジェクト ファイル(最初は Untitled project
)がルート ドライブ フォルダに配置されます。
コラボレーション
他のユーザーと共同編集してアドオンを開発する場合、1 つのユーザー アカウントがアドオン プロジェクトを所有します。アドオンを公開すると、1 つのユーザー アカウントがパブリッシャーとして機能します。公開アカウントにはアドオン スクリプト プロジェクトの編集権限が必要ですが、プロジェクト オーナーである必要はありません。
プロジェクトのオーナーが組織を離れたためにアドオンのコードまたは設定にアクセスできなくなる状況を避けることが非常に重要です。
アドオンコードにアクセスできなくなることを防ぐため、アドオンを共同編集する際は共有ドライブを使用することをおすすめします。アドオン スクリプト ファイルを共有ドライブに配置すると、アカウントがプロジェクトの唯一のオーナーになることがなくなります。
また、スクリプト プロジェクトの Cloud Platform(GCP)プロジェクトに共同編集者を追加することをおすすめします。これにより、チームのメンバーがアドオンのクラウド設定にいつでもアクセスできます。
アドオンのコーディング
スクリプト プロジェクトを作成したら、アドオンの外観と動作を定義するコードを記述できます。Apps Script の HtmlService で、従来の HTML と CSS を使ってアドオン ユーザー インターフェース(ダイアログとサイドバー)を作成します。エディタ アドオンでは、カスタム メニュー項目も定義できます。
コードを記述する際に、アドオンのユーザー エクスペリエンスの設計方法のガイドラインについて、エディタ アドオンのスタイルガイドをご覧ください。また、アドオンで発生する可能性のある承認ライフサイクルのさまざまな状態を理解してプログラムしてください。
アドオンをテストする
エディタ アドオンは、公開前にテストして、想定どおりに動作することを確認できます。テストでは、テスト構成を作成し、テスト ドキュメント、スプレッドシート、フォーム、またはプレゼンテーションを使用する必要があります。
詳しくは、エディタ アドオンをテストするをご覧ください。
アドオンを公開する
アドオンを公開すると、他のユーザー(一般公開またはドメイン内のユーザーのみ)がアドオンを使用できるようになります。公開プロセスを開始する前に、パブリケーションの概要を必ず確認してください。
エディタのアドオンは Google Workspace Marketplace で公開されています。一般公開されているアドオンは、公開前にアドオンの審査を完了する必要があります。
詳しくは、エディタ アドオンを公開するをご覧ください。