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