Google Workspace アドオンのテスト

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

アドオンを公開すると、ユーザーはホスト アプリケーションや Google Workspace Marketplace からインストールできます。ただし、公開する前に、拡張機能がホスト アプリケーション内で開発したアドオンをテストすることをおすすめします。

このページでは、テストまたは個人用に現在開発中のアドオン(非公開またはデベロッパー アドオン)をインストールする方法について説明します。

Prerequisites

  • アドオンのスクリプト プロジェクトに対する編集者権限が必要です。
  • 組織内の他のユーザーがアドオンをテストできるようにするには、スクリプト プロジェクトに対する編集者のアクセス権を付与します。アクセス権の付与の詳細については、他のデベロッパーとのコラボレーションをご覧ください。

未公開のアドオンをインストールする

Apps Script の [デプロイ] ダイアログで、非公開のアドオンをインストールできます。

公開を停止したGoogle Workspace アドオンをインストールする手順は次のとおりです。

  1. Apps Script エディタでスクリプト プロジェクトを開きます。
  2. [デプロイ] > [デプロイをテスト] をクリックします。
  3. [Install] をクリックします。
  4. 画面下部の [完了] をクリックします。

各自のアカウントで Apps Script プロジェクトを共有して、他のユーザーがアドオンをテストできるようにすることができます(編集権限が必要です)。その後、ユーザーに前述の手順を行うよう促します。

インストールすると、アドオンは拡張先のホスト アプリケーションで利用できます。アドオンが表示される前に、ホスト アプリケーションのタブの更新が必要になる場合があります。また、アドオンを使用する前に承認する必要もあります。

未公開のアドオンをアンインストールする

未公開のアドオンのデプロイをアンインストールする手順は次のとおりです。

  1. Apps Script エディタでスクリプト プロジェクトを開きます。
  2. [デプロイ] > [デプロイをテスト] をクリックします。
  3. [Uninstall] をクリックします。
  4. 画面下部の [完了] をクリックします。

この手順を行うと、直ちにデプロイが削除され、ホスト アプリケーションにはアドオンが表示されなくなります。インストール手順を繰り返すことで、いつでもデプロイを再インストールできます。

ベスト プラクティスを試す

Google Workspace アドオンをテストするときは、アドオンの開発に関するベスト プラクティスを実施してください。また、次のことを必ず行ってください。

  1. アドオンが拡張するすべてのホストアプリケーションで、カード ナビゲーション フローを十分にテストします。ユーザーがコンテキスト間やコンテキスト以外のカード間やコンテキスト以外のカード間を移動する際に、アドオンの動作が正しいことを確認します。

  2. サンプルのテストデータを使用してアドオンの動作を評価します。

  3. アドオンがサードパーティの API や他のサービスに接続している場合は、そのサービスにアクセスして想定どおりに動作することを確認します。アドオンが承認とログインの詳細を適切に処理していることを確認します。

  4. エラー条件があれば適切に対処します。必要に応じてエラーカードを使用します。

  5. アドオンのパフォーマンスに注意してください。コードに変更を加えた後、アドオンの動作が遅くなる場合は、その機能の削除または再作業が必要になることがあります。