アドオンを公開すると、ユーザーはホスト アプリケーションまたは Google Workspace Marketplace からアドオンをインストールできます。ただし、公開前に、開発したアドオンを拡張するホストアプリ内でアドオンをテストすることをおすすめします。
このページでは、テストや個人使用のために開発中のアドオン(いわゆる「非公開アドオン」または「デベロッパー アドオン」)をインストールする方法について説明します。
Prerequisites
- アドオンのスクリプト プロジェクトに対する編集者のアクセス権が必要です。
- 組織内の他のユーザーがアドオンをテストできるようにするには、スクリプト プロジェクトに対する編集者権限を付与します。アクセス権の付与について詳しくは、他のデベロッパーとの共同作業をご覧ください。
非公開のアドオンをインストールする
非公開アドオンは、Apps Script の [デプロイ] ダイアログからインストールできます。
テスト用に非公開の Google Workspace アドオンをインストールする手順は次のとおりです。
- Apps Script エディタでスクリプト プロジェクトを開きます。
- [デプロイ] > [デプロイをテスト] をクリックします。
- [Install] をクリックします。
- 下部にある [完了] をクリックします。
Apps Script プロジェクトを各自のアカウントと共有することで、他のユーザーがアドオンをテストできるようになります(編集権限が必要です)。続いて、ユーザーに上記の手順を行うよう求めます。
アドオンは、拡張されたホストアプリですぐに利用可能になります。アドオンが表示される前に、ホスト アプリケーションのタブを更新しなければならない場合があります。また、使用する前にアドオンを承認する必要があります。
非公開のアドオンをアンインストールする
非公開のアドオン デプロイメントをアンインストールする手順は次のとおりです。
- Apps Script エディタでスクリプト プロジェクトを開きます。
- [デプロイ] > [デプロイをテスト] をクリックします。
- [Uninstall] をクリックします。
- 下部にある [完了] をクリックします。
これらの手順を実行すると、直ちにデプロイメントが削除され、アドオンはどのホストアプリケーションにも表示されなくなります。インストール手順を繰り返すことで、いつでも Deployment を再インストールできます。
ベスト プラクティスを試す
Google Workspace アドオンをテストする際は、必ずアドオン開発のベスト プラクティスに従ってください。また、次のことを必ず行ってください。
アドオンによって拡張されるすべてのホストアプリでカード ナビゲーション フローを入念にテストします。ユーザーがコンテキストからコンテキストへ、または非コンテキスト カードとコンテキスト カード間を移動する際に、アドオンの動作が正しいことを確認します。
サンプルテストデータを使用して、アドオンの動作を評価します。
アドオンがサードパーティの API や他のサービスに接続する場合は、サービスにアクセスできることと、サービスが期待どおりに動作することを確認します。アドオンが承認とログインの詳細を正しく処理していることを確認してください。
エラー状態が適切に処理されていることを確認します。必要に応じてエラーカードを使用します。
アドオンのパフォーマンスに注意してください。コードに変更を加えてアドオンの動作が遅くなり始めた場合、その機能を削除するか、作り直す必要があります。