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

Google Workspace アドオンのテスト

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

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

要件

公開されていないアドオンをテストするために Google Workspaceインストールするには、そのアドオンのスクリプトプロジェクトへの編集権限が必要です。つまり、スクリプトのプロジェクトに対する編集権限を共同編集者に付与すれば、組織内の共同編集者にテストを任せることができます。

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

公開されていないテストのアドオンをGoogle Workspace インストールする手順は次のとおりです。

Apps Script エディタでアドオンのスクリプトプロジェクトを開きます。
[Publish > Deploy from manifest...] を選択して、[Deployments] ダイアログを開きます。
[最新バージョン（Head）] 行で、[アドオンをインストール] をクリックして、現在保存されているバージョンのアドオンを開発モードでインストールします。アドオンの最新バージョン（Head）をインストールすると、そのアドオンのコードに加えた変更はすべてすぐに適用されるため、再インストールする必要はありません。
または、バージョニングされたデプロイを作成してインストールすることもできます。これは、アドオンのバージョンを開発中のバージョンと比較するときに役立ちます。

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

インストール後のアドオンは、延長されたホストアプリケーションですぐに使用可能になります。アドオンが表示されない場合は、ホストアプリケーションのタブを更新してみてください。また、アドオンを使用する前に、承認する必要があります。

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

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

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

アドオンが拡張するすべてのホストアプリケーションでカードナビゲーションフローを十分にテストします。ユーザーがコンテキストからコンテキストに移動したとき、およびコンテキストなしカードとコンテキストカード間で移動したとき、アドオンの動作が正しく行われるようにします。
サンプルテストデータを使用して、アドオンの動作を評価します。
アドオンがサードパーティの API やその他のサービスに接続する場合は、そのサービスがアクセス可能で、想定どおりに動作することを確認します。アドオンが承認とログインの詳細を正しく処理していることを確認します。
エラー条件を適切に処理するようにします。必要に応じてエラーカードを使用します。
アドオンの性能に注意してください。コードに変更を加えた後、アドオンの動作が遅くなってきたら、その機能を削除するか、手直しする必要があります。