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

Apps Script Google Workspace アドオンをテストしてデバッグする

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

このページでは、テストや個人的な使用のために、開発中のアドオン（未公開またはデベロッパー アドオン）をインストールする方法について説明します。Apps Script IDE のデバッガとブレークポイントを使用してアドオンをデバッグすることもできます。

前提条件

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

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

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

他のユーザーにアドオンをテストしてもらうには、そのユーザーのアカウントと Apps Script プロジェクトを共有します（編集アクセス権が必要です）。上記の手順に沿って操作するようお客様に伝えます。

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

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

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

Google Workspace アドオンをテストする際は、アドオン開発のベストプラクティスに沿って行ってください。また、次の点にもご注意ください。

アドオンが拡張するすべてのホストアプリケーションで、カードナビゲーションフローを徹底的にテストします。ユーザーがコンテキストからコンテキストに移動したり、コンテキストに依存しないカードとコンテキストに依存するカードを切り替えたりするときに、アドオンの動作が正しいことを確認します。
サンプルテストデータを使用して、アドオンの動作を評価します。
アドオンがサードパーティの API やその他のサービスに接続する場合は、サービスにアクセスでき、想定どおりに動作することを確認します。アドオンが認証とログイン情報を正しく処理していることを確認します。
エラー状態が適切に処理されるようにします。必要に応じてエラーカードを使用します。
アドオンのパフォーマンスに注意してください。コードを変更した結果、アドオンの動作が遅くなった場合は、その機能を削除するか、作り直す必要があるかもしれません。