AppSheet を Apps Script に接続する

1. はじめに

この Codelab では、「Hello World」という名前の Apps Script プロジェクトを作成し、渡されたメッセージをログに記録する簡単な関数 logThis を追加します。次に、AppSheet Automation を作成して、スクリプトを呼び出します。スクリプトを呼び出した後、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. 新しい名前の [プロジェクトの名前変更] ダイアログ。 に変更します。
  3. エディタのスクリプトを次のように更新します。
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. [プロジェクトを保存] をクリックします。

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

3. AppSheet アプリを作成する

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

  1. Shirt Orders サンプル スプレッドシートを開き、[コピーを作成] をクリックしてコピーをダウンロードし、Google スプレッドシートで開きます。必要に応じて、スプレッドシートの名前を変更します（例: 「シャツの注文」）。
  2. AppSheet にログインします。
  3. [マイアプリ] ページで、[+ 新しいアプリを作成] をクリックします。[新しいアプリを作成] ダイアログが表示されます。
  4. [Start with your own data] をクリックします。[New App Creation] ダイアログ。
  5. アプリの名称とカテゴリを編集することもできます。
  6. [Choose your data] をクリックします。

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

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

AppSheet がアプリを設定します。生成されたアプリの最初のプレビュー ウィンドウ。

  1. [Customize your app] をクリックし、AppSheet エディタでアプリを開きます。

4. 自動化を作成する

次に、AppSheet Automation を作成して、スクリプトを呼び出します。

  1. [Automation] > [Bots] を選択します。
  2. [+ 新しいボット] をクリックします。
  3. 候補リストから [When a Shirt Orders record is created or updated, send a notification] を選択します。

5037cdd726e326e9.png

  1. [Send a notification] ステップをクリックし、編集します。
  2. 名前を「Call a script」に変更します。

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

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

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

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

Apps Script のプロジェクトが追加され、使用可能な関数のリストが [Function Name] フィールドに入力されます。

  1. [関数名] リストから [logThis(msg)] を選択します。プルダウンで Apps Script 関数「logThis()」を選択している。

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

  1. msg 引数に対して、Expression Assistant を使用して以下の式を入力します。‘Hello from AppSheet'

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

  1. [Save] をクリックしてアプリを保存します。
  2. プレビュー パネルでスマートホンかタブレットのアイコンをクリックし、アプリのエミュレータを表示させます。

68471f4646fc8fbe.png

  1. シャツの注文を新たに追加し、[Save] をクリックします。
  2. [Sync] をクリックし、変更を同期させます。

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

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 プロジェクトを紹介しています。