AppSheet と Apps Script を接続する

1. はじめに

この Codelab では、「Hello World」という名前の Apps Script プロジェクトを作成し、渡されたメッセージをログに記録するシンプルな関数 logThis を追加します。次に、AppSheet 自動化を作成し、スクリプトを呼び出します。スクリプトが呼び出されたら、Apps Script エディタに戻って実行を確認します。

学習内容

  • シンプルな関数を使用して Apps Script プロジェクトを作成する方法。
  • 既存の Google スプレッドシートを基にシンプルな AppSheet アプリを作成する方法。
  • スクリプト関数を呼び出す AppSheet Automation を作成する方法。
  • AppSheet からスクリプトが正常に実行されたことを確認する方法。

必要なもの

  • AppSheet 開発環境（appsheet.com）へのアクセス
  • Apps Script 開発環境（script.google.com）へのアクセス権。

2. Apps Script プロジェクトを作成する

まず、「Hello World」という名前の Apps Script プロジェクトを作成し、次に、渡されたメッセージをログに記録するシンプルな関数 logThis を追加します。

  1. Apps Script のホームページに移動し、[+ 新しいプロジェクト] をクリックします。
  2. プロジェクトのタイトルを「Hello World. [Rename Project] ダイアログで新しい名前を使用する。」に変更します
  3. エディタでスクリプトを次のように更新します。
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. [プロジェクトを保存] をクリックします。

詳細については、プロジェクトの作成と削除をご覧ください。

3. AppSheet アプリを作成する

次に、コピーした Google スプレッドシートの例に基づいて新しい AppSheet アプリをすばやく生成し、そのデータセットに先ほど作成した Apps Script プロジェクトを呼び出すように更新します。

  1. 開くシャツの注文例スプレッドシートをクリックしてコピーを作成Google スプレッドシートでファイルをダウンロードして開きます。必要に応じてスプレッドシートの名前変更（「シャツの注文」など）もできます。
  2. AppSheet にログインします。
  3. [My apps] ページで、[+ Make a new app] をクリックします。 [新しいアプリを作成] ダイアログが表示されます。
  4. [独自のデータで開始] をクリックします。 新しいアプリ作成ダイアログ
  5. 必要に応じてアプリ名を編集し、カテゴリを選択します。
  6. [自分のデータの選択] をクリックします。

新しいアプリの作成ダイアログで [データを選択する] を選択する

  1. [google] をクリックして、Google ドライブにアクセスします。
  2. 先ほどコピーした [Shirt Orders] スプレッドシートに移動して選択します。

AppSheet によってアプリがセットアップされます。 生成されたアプリの最初のプレビュー ウィンドウ。 さん

  1. [アプリをカスタマイズ] をクリックして、AppSheet エディタでアプリを開きます。

4.自動化の作成

次に、AppSheet 自動化を作成し、スクリプトを呼び出します。

  1. [Automation] > [Bots] を選択します。
  2. [+ New Bot] をクリックします。
  3. 候補のリストの最初の項目を選択します（シャツの注文の記録を作成または更新したら、通知を送信します）。

5037cdd726e326e9.png

  1. [通知を送信する] ステップをクリックして編集します。
  2. 名前を「Call a script」に変更します。

スクリプトを呼び出す自動化の手順。

  1. [Settings] で、タスクタイプを [Call a script] に変更します。

[自動化] 設定で [スクリプトの呼び出し] タスクタイプを選択します。

  1. [Apps Script Project] で [Browse]（ファイル アイコン）をクリックします。
  2. ドライブで Hello World の Apps Script プロジェクトに移動し、プロジェクトを選択します。
  3. [選択] をクリックします。承認を求められたら、[承認] をクリックして画面の指示に従います。

Apps Script プロジェクトが追加され、[関数名] に使用可能な関数のリストが表示されます。

  1. [Function Name] リストから [logThis(msg)] を選択します。 プルダウンから Apps Script 関数 [logThis()] を選択します。

[Function Arguments] フィールドが表示されます。

  1. msg 引数に Expression Assistant を使用して「Hello from AppSheet」と入力します。

Apps Script 関数呼び出しに引数を追加する。

  1. [Save] をクリックしてアプリを保存します。
  2. プレビュー パネルでモバイルまたはタブレットのアイコンをクリックし、アプリ エミュレータを表示します。

68471f4646fc8fbe.png

  1. 新しいシャツの注文を追加して、[保存] をクリックします。
  2. [同期] をクリックして変更内容を同期します。

プレビュー パネルの右上にある同期アイコンをクリックして、データソースと同期させます。

5. Apps Script の実行を確認する

スクリプトが呼び出されたら、Apps Script エディタに戻り、実行を確認します。

  1. Apps Script のホームページに戻り、Hello World プロジェクトを表示します。
  2. ナビゲーション バーの [実行数] をクリックして、logThis 関数が正常に完了したことを確認します。ログが表示されない場合は、[更新] をクリックします。

Apps Script エディタ環境で実行ログを表示し、AppSheet 呼び出しから関数の実行を確認します。

6. 省略可能な追加手順

このワークショップの追加手順として、Apps Script サンプル プロジェクトを確認し、AppSheet でいくつかのサンプルを実行します。

Apps Script スタートガイド

  1. まず、Apps Script サンプル プロジェクトのコピーを作成します。
  2. コピーアイコンをクリックします。
  3. 新しいプロジェクトを保存し、[実行] をクリックしてプロジェクト内のアプリを承認します。

いくつかの例で試す

  • createCalendarEvent() - 新しいカレンダーの予定を作成します。
  • createDoc() - 新しいドキュメントを自動的に作成します。
  • createSheet() - 新しいシートを作成します。
  • createSlideDeck() - 画像とテキストを使用して新しいスライド資料を作成します。

この重要な機能について詳しくは、自動化から Apps Script を呼び出すをご覧ください。詳細な概要、機能動画、チュートリアルのほか、多くの AppSheet-Apps Script の実用例を含むコピー可能な Apps Script プロジェクトが提供されています。