Apps Script ダッシュボード

Apps Script ダッシュボードでは、Apps Script プロジェクトを管理およびモニタリングできます。ダッシュボードを使用して、次のことができます。

  • 既存の Apps Script プロジェクト(Google Workspace ドキュメントに添付されたバインドされたスクリプトを含む)を表示および検索する。
  • 新しいプロジェクトを作成する。
  • 使用する OAuth スコープなど、プロジェクトの詳細を表示する。
  • スクリプト プロジェクトの健全性と使用状況をモニタリングします。
  • アカウントの認証情報を使用して実行されるプロジェクトやその他のプロジェクトの実行ログを表示します。
  • [Apps Script API] をオンまたはオフに切り替えて、アプリによるスクリプト プロジェクトの操作を許可または禁止します。

プロジェクトの表示と検索

Apps Script ダッシュボードには、表示または編集可能なすべてのスクリプト プロジェクトが一覧表示されます。ダッシュボードの左側のナビゲーションでは、これらのプロジェクトが以下のカテゴリに分類されています。

  • スター付きプロジェクトmonitoringしているプロジェクト。
  • マイ プロジェクト。自分がオーナーとなっているプロジェクト。
  • すべてのプロジェクト。自分が所有しているプロジェクト、または閲覧権限または編集権限を持っているプロジェクト。
  • 共有アイテム。自分が所有していないが、共有されているプロジェクト。
  • ゴミ箱。Google ドライブから削除したプロジェクト。

プロジェクト リストには、プロジェクト名、オーナー、最終更新日が表示されます。プロジェクト名の横にあるアイコンは、プロジェクトがスタンドアロン プロジェクトかバインド プロジェクトかを示します。

プロジェクトの詳細を表示

各プロジェクトには、プロジェクトに関するデベロッパーの詳細を確認するためのビューがあります。プロジェクトの詳細を表示するには、プロジェクト リストの行をクリックします。

プロジェクトの詳細ビューには、プロジェクトに関する [エラー率]、[実行数]、[ユーザー] のデータとグラフ、さらに、プロジェクトを使用するエンドユーザーにリクエストされた OAuth スコープが表示されます。データ指標は次のように定義されます。

  • エラー率。キャッチされなかった例外が原因で実行に失敗した実行の割合。これは、失敗した実行数を、定義された期間の合計実行数で割って計算されます。
  • 実行。プロジェクトが「実行」または実行された回数。プロジェクトの実行方法について詳しくは、実行タイプをご覧ください。
  • ユーザー:指定した期間にプロジェクトを 1 回以上実行したユニーク ユーザー(アカウント)の数。匿名ユーザーは追跡されないため、ユーザー数やグラフには反映されません。

プロジェクトの各デプロイは、[プロジェクトの詳細] ページのデータとグラフの上にタブとして表示されます。タブを選択すると、そのデプロイに関連するデータを表示できます。[すべて] を選択すると、プロジェクトのすべてのデプロイに関する集計データと、デベロッパーが Apps Script コードエディタ内でプロジェクトを実行したことによる実行の集計データが表示されます。

プロジェクトをモニタリングする

定期的に使用または管理しているアカウントよりも、はるかに多くの Apps Script プロジェクトにアクセスできる可能性があります。プロジェクトにスターを付けると、ブックマークしたプロジェクトに簡単にアクセスできます。 プロジェクトにスターを付けると、使用量とエラー率の集計統計と、それらのプロジェクトに関するグラフをモニタリングすることもできます。

プロジェクトにスターを付けるには、プロジェクト行の右側にあるその他アイコン > [スターを追加] をクリックします。プロジェクトの詳細を表示しているときにその他アイコン をクリックして、プロジェクトにスターを付けることもできます。

左側のナビゲーションで [スター付きのプロジェクト] を選択すると、ブックマークしたプロジェクトが表示されます。ページの上部にある [エラー率]、[実行数]、または [ユーザー] のスコアカードをクリックすると、過去 7 日間にスター付きのすべてのプロジェクトの関連グラフが表示されます。

プロジェクトからスターを削除するには、プロジェクトの行にあるその他アイコン をクリックし、[スターを外す] を選択します。

実行を管理する

Apps Script ダッシュボードを使用すると、Apps Script プロジェクト関数の個々の実行を表示して管理できます。左側のナビゲーションで [My Executions] を選択すると、最近の実行のすべてのログが表示されます。

デフォルトでは、[My Executions] パネルには、自分がオーナー、編集者、閲覧者であるプロジェクトの過去および現在実行中のすべての実行のログが表示されます。このリストには、ユーザーに代わって実行された場合にアクセス権のないプロジェクトでの関数の実行(ユーザーがインストールして実行したアドオンなど)も含まれます。実行リストには、実行を開始するために呼び出される最初の関数のみが表示されます。実行中に呼び出されたすべての関数が表示されるわけではありません。

ビューの上部にあるフィルタを使用して、ログに記録される実行の種類を制御できます。ログの各行は 1 回の実行を表します。[開始時間]、[期間]、[ステータス] 列には、その実行に関する対応する情報が表示されます。

[関数] 列には、実行を開始した関数の名前が表示されます。実行の対応するスクリプト プロジェクトへのアクセス権がないが、実行された場合、この列に名前は表示されません。

[タイプ] 列には、実行を開始した理由が表示されます。次の値があります。

  • アドオン:アドオンから実行されました。
  • Execution APIApps Script API の呼び出しによって実行されました。
  • 時間駆動型。タイムイベントによって実行が行われました。
  • トリガー。実行がトリガーソースから行われた。
  • ウェブアプリ。デプロイしたウェブアプリから実行されました。
  • 編集者。実行は Apps Script エディタから行われました。

実行を終了する

現在進行中の長時間実行の実行は、[ステータス] に「実行中」と表示されます。これらの実行を停止するには、プロジェクト行の右側にあるその他アイコン > [終了] をクリックします。

設定

ダッシュボードの設定を調整するには、左側のナビゲーションで [設定] を選択します。

[設定] パネルでは、Apps Script API をオンに切り替えます。これにより、API にスクリプト プロジェクトへのアクセス権を付与できるようになります。

この切り替えボタンにアクセスするには、[設定] パネルで [Google Apps Script API] ラベルをクリックします。新しいパネルが開き、警告テキストと切り替えスイッチが表示されます。デフォルトでは、スクリプト プロジェクトへのアクセスはセキュリティ対策としてオフになっています。アクセス権を付与すると、認可したサードパーティ アプリケーションは API を使用してスクリプトやデプロイを変更できるようになります。このアクセス権は、[設定] パネルでいつでも取り消すことができます。

詳しくは、Apps Script API アクセスガイドをご覧ください。