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. Shirt Orders サンプル スプレッドシートを開き、[Make a copy] をクリックしてコピーをダウンロードし、Google スプレッドシートで開きます。必要に応じて、スプレッドシートの名前を変更することもできます（例: 「Shirt Orders」）。
  2. AppSheet にログインします。
  3. [My apps] ページで、[+ Make a new app] をクリックします。[Create a new app] ダイアログが表示されます。
  4. [Start with your own data] をクリックします。新しいアプリ作成ダイアログ。
  5. アプリの名称とカテゴリを編集することもできます。
  6. [Choose your data] をクリックします。

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

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

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

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

4. 自動化を作成する

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

  1. [Automation] > [Bots] を選択します。
  2. [+ New Bot] をクリックします。
  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] に変更します。

[Call a script]タスクタイプを指定する必要があります。

  1. [Apps Script Project] フィールドで、[Browse]（ファイルのアイコン）をクリックします。
  2. ドライブ内の 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. ナビゲーション バーで [Executions] をクリックし、logThis 関数が正常に完了したことを確認します。ログが表示されない場合は、[更新] をクリックします。

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

6. 追加の手順（省略可）

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

Apps Script サンプルを使ってみる

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

いくつかの例を試す

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

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