エディタのアドオンをテストする

アドオンを公開する前に徹底的にテストして、要件を満たしていることを確認する 確認します。Apps Script では、 エディタのアドオン 特定の Google ドキュメントのスプレッドシート、フォーム、スライドのファイルでの開発。この 次のような用途に使用できます。

  • スタンドアロン スクリプトで記述されたアドオンが意図したとおりに機能することを確認する スプレッドシート、ドキュメント、プレゼンテーション、フォームに適用した場合。
  • アドオンのインストール フローが意図したとおりに機能することを確認します(特に イニシャル 承認ライフサイクルの状態インストール済み、有効、またはその両方)。
  • 特定の Google Cloud プロダクトでアドオンが意図したとおりに ドキュメントとその内容が含まれます。
  • アドオンの現在のバージョンと以前のバージョンをテストして比較できます。

テストデプロイを作成する

テストデプロイは、アドオンとテスト ドキュメントを組み合わせたものです。 開発したスクリプトをアドオンとしてテストするには 手順は次のとおりです。

  1. まだお持ちでない場合は、スプレッドシート、ドキュメント、 アドオンのテストに使用する プレゼンテーション、またはフォームです
  2. アドオンを含むスクリプト プロジェクトを開きます。
  3. [デプロイ] > [デプロイをテスト] をクリックします。
  4. [タイプを選択] の横にある「デプロイタイプを有効にする」アイコン をクリックします。 [エディタのアドオン] を選択します。
  5. [新しいテストを作成] または [テストを追加] をクリックします。
  6. コード バージョンを選択するか、[最新のコード] を選択します。
  7. [Config] セクションで、テストの初期承認状態を選択します。
  8. [テスト ドキュメント] で [ドキュメントが選択されていません] をクリックします。スプレッドシート、ドキュメント、 アドオンのテストに使用するスライドまたはフォーム ファイルを選択して [挿入] をクリックします。
  9. [テストを保存] をクリックします。

保存したすべてのテストデプロイが [テストデプロイ] ダイアログに表示されます。これにより、 後で同じテストデプロイに再度アクセスします。

テストデプロイを実行する

保存済みのテストデプロイが 1 つ以上ある場合は、そのいずれかを実行できます。 手順は次のとおりです。

  1. アドオンを含むスクリプト プロジェクトを開きます。
  2. [デプロイ] > [デプロイをテスト] をクリックします。
  3. [Saved Tests] で、保存したテストの横にあるラジオボタンを選択します。 [Execute] をクリックします。

テスト ドキュメントが新しいタブで開きます。アドオンは 認可状態 テストデプロイに指定します。アドオンが次のように機能することを確認できます。 操作することで意図したとおりに操作できます。

テストの詳細

エディタ アドオンをテストする際の注意事項 できます。

  • インストール可能なトリガー はサポートされていません。インストール可能に依存する機能 トリガーをテストできません。
  • 最新のコードでテストするように設定されたテストデプロイの実行時に、 テスト ドキュメントを更新して、アドオン スクリプトに保存された変更を確認できます。
  • テスト ドキュメントには、元のドキュメントの編集者と共有できる URL が含まれています テスト ドキュメントです。こうすることで、他のユーザーとのコラボレーションが テストと開発に費やすことができます
  • アドオンで Properties サービス プロパティは維持され、次回のテストデプロイ時に利用可能になります 実行されます。
  • また、アドオンと Cloud SDK の同じ組み合わせを使用するテスト デプロイも、 テスト ドキュメントは同じプロパティ情報にアクセスできます。たとえば、 2 つのテストデプロイを作成します。最初のデプロイの実行中に保存されたプロパティは、 2 番目の実行時でもその逆も可能ですが、 同じスクリプトとテスト ドキュメントを使用します。
  • テストデプロイを実行する際、次の場合に承認を求められることがあります。 実行したことがないことを確認します。ただし、スクリプトの承認中にスクリプトを承認すると、 テストでは、テスト外でもスクリプトを承認します。