このページは Cloud Translation API によって翻訳されました。

Google Workspace アドオンのテスト

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

このページでは、テストや個人使用のために開発中のアドオン（いわゆる「非公開アドオン」または「デベロッパーアドオン」）をインストールする方法について説明します。

Prerequisites

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

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

テスト用に非公開の Google Workspace アドオンをインストールする手順は次のとおりです。

Apps Script プロジェクトを各自のアカウントと共有することで、他のユーザーがアドオンをテストできるようになります（編集権限が必要です）。続いて、ユーザーに上記の手順を行うよう求めます。

アドオンは、拡張されたホストアプリですぐに利用可能になります。アドオンが表示される前に、ホストアプリケーションのタブを更新しなければならない場合があります。また、使用する前にアドオンを承認する必要があります。

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

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

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

アドオンによって拡張されるすべてのホストアプリでカードナビゲーションフローを入念にテストします。ユーザーがコンテキストからコンテキストへ、または非コンテキストカードとコンテキストカード間を移動する際に、アドオンの動作が正しいことを確認します。
サンプルテストデータを使用して、アドオンの動作を評価します。
アドオンがサードパーティの API や他のサービスに接続する場合は、サービスにアクセスできることと、サービスが期待どおりに動作することを確認します。アドオンが承認とログインの詳細を正しく処理していることを確認してください。
エラー状態が適切に処理されていることを確認します。必要に応じてエラーカードを使用します。
アドオンのパフォーマンスに注意してください。コードに変更を加えてアドオンの動作が遅くなり始めた場合、その機能を削除するか、作り直す必要があります。