Google スプレッドシートからワークフローをトリガーする

Google スプレッドシートは、リアルタイムでの共同編集が可能な、データの可視化、処理、通信のためのツールを提供するクラウドベースのスプレッドシートソリューションです。

このチュートリアルでは、スプレッドシートから Workflows をトリガーする方法について説明します。

目標

このチュートリアルの内容は次のとおりです。

クラウドベースのアンケートソリューションである Google フォームを使用して、仮想マシン（VM）インスタンスの作成リクエストを送信できるフォームを作成します。
Google スプレッドシートをフォームにリンクして、回答を収集して保存します。
Google Apps Script（クラウドベースの JavaScript プラットフォーム）を使用して、Google Workspace プロダクトの作成、読み取り、編集をプログラムで行い、スプレッドシートの更新を通してリクエストが承認されるたびにワークフローをトリガーします。
Compute Engine API コネクタを呼び出すワークフローをデプロイし、フォームから収集した仕様に基づいて Compute Engine VM インスタンスを作成します。コネクタを使用すると、他の Google Cloud APIs の呼び出しが簡素化されます。Workflows コネクタの詳細を確認する。
プロセス全体をテストして、VM インスタンスが想定どおりに作成されていることを確認します。

費用

このドキュメントでは、Google Cloud の次の課金対象のコンポーネントを使用します。

料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。新しい Google Cloud ユーザーは無料トライアルをご利用いただける場合があります。

このチュートリアルでは、Google Workspace も使用します。Google の無料の一般ユーザー向けアプリに含まれていないビジネスレベルのサービスは、課金対象になります。

始める前に

Google Cloud コンソールで次のコマンドを実行するか、ターミナルまたは Cloud Shell で Google Cloud CLI を使用できます。

組織で定義されているセキュリティの制約により、次の手順を完了できない場合があります。トラブルシューティング情報については、制約のある Google Cloud 環境でアプリケーションを開発するをご覧ください。

コンソール

Google Cloud コンソールのプロジェクトセレクタページで、Google Cloud プロジェクトを選択または作成します。

注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。
プロジェクトセレクタに移動
Google Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
Compute Engine API と Workflows API を有効にします。

API を有効にする
Compute Engine のデフォルトのサービスアカウントをメモしておいてください。テスト目的で、このチュートリアルのワークフローに関連付けるためです。Compute Engine API が有効になっている新しいプロジェクトには、IAM 基本編集者ロールや、以下のメール形式を持つサービスアカウントが作成されます。
```
PROJECT_NUMBER-compute@developer.gserviceaccount.com
```
プロジェクト番号は、Google Cloud コンソールの [ようこそ] ページで確認できます。

本番環境では、新しいサービスアカウントを作成して、必要最小限のアクセス許可を含む、最小権限の原則に従った 1 つ以上の IAM ロールを付与することを強くおすすめします。
注:
iam.automaticIamGrantsForDefaultServiceAccounts 組織のポリシーの制約により、編集者のロールはデフォルトのサービスアカウントに自動的に付与されません。2024 年 5 月 3 日より後に組織を作成した場合、この制約はデフォルトで適用されます。

この制約を適用して、ロールの自動付与を無効にすることを強くおすすめします。ロールの自動付与を無効にする場合は、デフォルトのサービスアカウントに付与するロールを決定し、ご自身でこれらのロールを付与する必要があります。

デフォルトのサービスアカウントにすでに編集者ロールが設定されている場合は、編集者ロールを権限の低いロールに置き換えることをおすすめします。サービスアカウントのロールを安全に変更するには、Policy Simulator を使用して変更の影響を確認してから、適切なロールを付与または取り消す操作を行います。

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Google Cloud プロジェクトの課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

Compute Engine API と Workflows API を有効にします。

gcloud services enable \
    compute.googleapis.com \
    workflows.googleapis.com

Compute Engine のデフォルトのサービスアカウントをメモしておいてください。テスト目的で、このチュートリアルのワークフローに関連付けるためです。Compute Engine API が有効になっている新しいプロジェクトには、IAM 基本編集者ロールや、以下のメール形式を持つサービスアカウントが作成されます。
```
PROJECT_NUMBER-compute@developer.gserviceaccount.com
```
プロジェクト番号を取得します。
```
gcloud projects describe PROJECT_ID
```
本番環境では、新しいサービスアカウントを作成して、必要最小限のアクセス許可を含む、最小権限の原則に従った 1 つ以上の IAM ロールを付与することを強くおすすめします。
注:
iam.automaticIamGrantsForDefaultServiceAccounts 組織のポリシーの制約により、編集者のロールはデフォルトのサービスアカウントに自動的に付与されません。2024 年 5 月 3 日より後に組織を作成した場合、この制約はデフォルトで適用されます。

この制約を適用して、ロールの自動付与を無効にすることを強くおすすめします。ロールの自動付与を無効にする場合は、デフォルトのサービスアカウントに付与するロールを決定し、ご自身でこれらのロールを付与する必要があります。

デフォルトのサービスアカウントにすでに編集者ロールが設定されている場合は、編集者ロールを権限の低いロールに置き換えることをおすすめします。サービスアカウントのロールを安全に変更するには、Policy Simulator を使用して変更の影響を確認してから、適切なロールを付与または取り消す操作を行います。

VM インスタンスをリクエストするフォームを作成する

Compute Engine 仮想マシン（VM）インスタンスの作成リクエストを送信するために使用できるフォームを作成します。デフォルトでは、Google フォームで作成したフォームは Google ドライブに保存されます。

forms.google.com にアクセスします。
空白をクリックします。
新しいフォームが開きます。

5 つの必須セクションを含むフォームを作成します。フォームは次のようになります。

サンプルフォームを表示する

マシン名	記述式テキスト（短文回答）
ゾーン	（プルダウン） us-central1-a us-central1-b us-central1-c us-central1-f
型	（プルダウン） e2-micro e2-small e2-medium e2-standard-2 e2-standard-4
Disk size (GB)	記述式テキスト（短文回答）
OS	（プルダウン） debian-10 centos-stream-9 cos-93-lts cos-97-lts

メールアドレスの収集を有効にして、フォームに記入したユーザーのメールアドレスを記録します。
1. [設定] をクリックします。
2. [回答] セクションを開きます。
3. [メールアドレスを収集する] をオンにします。

スプレッドシートをフォームにリンクする

フォームを作成したら、スプレッドシートをフォームにリンクして、フォームの回答をスプレッドシートに保存できるようにします。スプレッドシートはドライブに保存されます。

フォームでフォームを開きます。
[回答] をクリックします。
[Google スプレッドシートにリンク] をクリックします。
[回答先の選択] ダイアログで、[新しいスプレッドシートを作成] を選択します。
[作成] をクリックします。

リンク先のスプレッドシートが開きます。
列 [H] に、[承認済みか？] 見出しを追加します。
列 [H] の最初の行にカーソルを合わせ、[挿入] > [チェックボックス] を選択します。

スプレッドシートは次のようになります。

回答でシートが更新されるたびに、その回答の行にもこのチェックボックスが表示されます。

Apps Script を使用して Google スプレッドシートを拡張する

Apps Script を使用すると、Google スプレッドシートの作成、読み取り、編集をプログラムで行うことができます。Google スプレッドシート用に設計されたほとんどのスクリプトでは、配列を操作してスプレッドシート内のセル、行、列を操作することができます。Google スプレッドシートで Apps Script を使用する方法については、カスタム関数のクイックスタートをご覧ください。

Google スプレッドシートから Apps Script プロジェクトを作成する:
1. Google スプレッドシートを開きます。
2. [拡張機能] > [Apps Script] を選択します。
3. スクリプトエディタで、[無題のプロジェクト] をクリックします。
4. プロジェクトに名前を付けて、[名前を変更する] をクリックします。
これで、スクリプトがスプレッドシートにバインドされます。これにより、スクリプトでユーザーインターフェースを変更したり、スプレッドシートを開いたときに応答したりできます。

スクリプトプロジェクトは、Apps Script のファイルとリソースのコレクションを表します。スクリプトプロジェクトのコードファイルの拡張子は .gs です。

Apps Script を使用すると、組み込み関数のように Google スプレッドシートで使用できるカスタム関数を作成できます。カスタム関数は、標準の JavaScript を使用して作成されます。関数を作成する

Apps Script プロジェクトを開きます。
[編集者] をクリックします。
スクリプトファイルは、Code.gs という名前のプロジェクトファイルとして表示されます。ファイルを編集するには、そのファイルを選択します。

スクリプトエディタのコードを次のコードに置き換えます。このコードは、スプレッドシート内のデータを読み取り、ワークフロー実行への入力として渡します。

const PROJECT_ID = "your-project-id";
const REGION = "us-central1";
const WORKFLOW = "create-vm-from-form";

function handleEdit(e) {
  var range = e.range.getA1Notation();
  var sheet = e.source;

  if (range.length > 1 && range[0] === 'H') {
    if (e.value == "TRUE") {
      Logger.log("Approved checkbox: true");

      var row = range.slice(1)
      var email = sheet.getRange('B' + row).getCell(1, 1).getValue()
      var vmName = sheet.getRange('c' + row).getCell(1, 1).getValue()
      var zone = sheet.getRange('D' + row).getCell(1, 1).getValue()
      var machineType = sheet.getRange('E' + row).getCell(1, 1).getValue()
      var diskSize = sheet.getRange('F' + row).getCell(1, 1).getValue()
      var imageFamily = sheet.getRange('G' + row).getCell(1, 1).getValue()
      var imageProject = imageFamily.substring(0, imageFamily.indexOf('-')) + "-cloud"

      const executionPayload = {
        "argument": "{\"diskSize\": \"" + diskSize + "\", \"email\": \"" + email + "\", \"imageFamily\": \"" + imageFamily + "\", \"imageProject\": \"" + imageProject + "\", \"machineType\": \"" + machineType + "\", \"vmName\": \"" + vmName + "\", \"zone\": \"" + zone +  "\"}"
      };

      approve(executionPayload);
    }
    else {
      Logger.log("Approved checkbox: false");
    }
  }
}

function approve(executionPayload) {
  const headers = {
    "Authorization": "Bearer " + ScriptApp.getOAuthToken()
  };

  const params = {
    "method": 'post',
    "contentType": 'application/json',
    "headers": headers,
    "payload": JSON.stringify(executionPayload)
  };

  const url = "https://workflowexecutions.googleapis.com/v1/projects/" + PROJECT_ID + "/locations/" + REGION + "/workflows/" + WORKFLOW + "/executions";

  Logger.log("Workflow execution request to " + url);
  var response = UrlFetchApp.fetch(url, params);
  Logger.log(response);
}

your-project-id は、Google Cloud プロジェクト ID に置き換えます。

プロジェクト ID は、Google Cloud コンソールの [ようこそ] ページで確認できます。
[保存] をクリックします。

Apps Script のインストール可能なトリガーを使用すると、スプレッドシートを開いたり編集したりしたときなど、特定の条件が満たされたときに、スクリプトプロジェクトが指定された関数を実行できるようになります。トリガーを作成する
1. Apps Script プロジェクトを開きます。
2. [トリガー] をクリックします。
3. [トリガーを追加] をクリックします。
4. [YOUR_PROJECT_NAME のトリガーを追加] ダイアログで、トリガーを構成します。
  1. [実行する関数を選択] リストで、[handleEdit] を選択します。
  2. [実行するデプロイを選択] リストで、[Head] を選択します。
  3. [イベントソースを選択] リストで、[スプレッドシートから] を選択します。
  4. [イベントタイプを選択] リストで、[編集時] を選択します。
  5. [障害通知設定] リストで、[毎日通知] を選択します。
5. [保存] をクリックします。
6. Google アカウントを選択するように求められたら、適切なアカウントを選択して [許可] をクリックします。
  
  これにより、Apps Script プロジェクトが Google スプレッドシートのシートを表示、編集、作成、削除し、外部サービスに接続できるようになります。
Apps Script プロジェクトのマニフェストファイルは、Apps Script がスクリプトを正常に実行するために必要な基本的なプロジェクト情報を指定する JSON ファイルです。Apps Script エディタでは、Apps Script プロジェクト設定を保護するため、デフォルトでマニフェストファイルが非表示になります。マニフェストファイルを編集します。
1. Apps Script プロジェクトを開きます。
2. [プロジェクトの設定] をクリックします。
3. [「appsscript.json」マニフェストファイルをエディタで表示する] チェックボックスをオンにします。
4. [編集者] をクリックします。
5. マニフェストファイルは、appsscript.json という名前のプロジェクトファイルとして表示されます。ファイルを編集するには、そのファイルを選択します。
6. oauthScopes フィールドは、文字列の配列を指定します。プロジェクトで使用する認証スコープを設定するには、サポートするスコープを含む配列を追加します。次に例を示します。
```
{
  "timeZone": "America/Toronto",
  "dependencies": {
  },
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/cloud-platform",
    "https://www.googleapis.com/auth/spreadsheets"
  ]
}
```
  これにより、明示的なスコープが次のように設定されます。
  - 外部サービスへの接続
  - Google Cloud のデータの表示、編集、設定、削除、および Google アカウントのメールアドレスの表示
  - Google スプレッドシートのすべてのスプレッドシートの表示、編集、作成、削除
7. [保存] をクリックします。
注: プロジェクトの設定を保護するため、編集が終わったらエディタで「appsscript.json」マニフェストファイルを表示するチェックボックスを消去し、マニフェストを非表示にします。

VM インスタンスを作成するワークフローをデプロイする

VM インスタンスの作成リクエストが承認されたときにトリガーされるワークフローをデプロイします。ワークフローは Compute Engine API コネクタを呼び出し、フォームから収集した仕様に基づいて Compute Engine VM インスタンスを作成します。

Console

Google Cloud コンソールの [ワークフロー] ページに移動します。

[ワークフロー] に移動
[ 作成] をクリックします。
新しいフィールドの名前を入力します: create-vm-from-form。
[リージョン] リストで [us-central1 (Iowa)] を選択します。
[サービスアカウント] で、Compute Engine のデフォルトのサービスアカウント（PROJECT_NUMBER-compute@developer.gserviceaccount.com）を選択します。
[次へ] をクリックします。

ワークフローエディタで、次のワークフローの定義を入力します。

main:
   params: [input]
   steps:
   - init:
       assign:
            - projectId: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
            - zone: ${input.zone}
            - machineType: ${input.machineType}
            - diskSize: ${input.diskSize}
            - imageProject: ${input.imageProject}
            - imageFamily: ${input.imageFamily}
            - vmName: ${input.vmName}
            - email: ${input.email}
   - createResource:
       call: googleapis.compute.v1.instances.insert
       args:
           project: ${projectId}
           zone: ${zone}
           body:
               name: ${vmName}
               machineType: ${"projects/" + projectId + "/zones/" + zone + "/machineTypes/" + machineType}
               disks:
                - initializeParams:
                    diskSizeGb: ${diskSize}
                    sourceImage: ${"projects/" + imageProject + "/global/images/family/" + imageFamily}
                  type: PERSISTENT
                  boot: true
                  autoDelete: true
               networkInterfaces:
                - network: "global/networks/default"
       result: insertResult
   - retStep:
       return: ${insertResult}

[デプロイ] をクリックします。

gcloud

ワークフローのソースコードファイルを作成します。
```
touch create-vm-from-form.yaml
```

テキストエディタで、次のワークフローをソースコードファイルにコピーします。

main:
   params: [input]
   steps:
   - init:
       assign:
            - projectId: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
            - zone: ${input.zone}
            - machineType: ${input.machineType}
            - diskSize: ${input.diskSize}
            - imageProject: ${input.imageProject}
            - imageFamily: ${input.imageFamily}
            - vmName: ${input.vmName}
            - email: ${input.email}
   - createResource:
       call: googleapis.compute.v1.instances.insert
       args:
           project: ${projectId}
           zone: ${zone}
           body:
               name: ${vmName}
               machineType: ${"projects/" + projectId + "/zones/" + zone + "/machineTypes/" + machineType}
               disks:
                - initializeParams:
                    diskSizeGb: ${diskSize}
                    sourceImage: ${"projects/" + imageProject + "/global/images/family/" + imageFamily}
                  type: PERSISTENT
                  boot: true
                  autoDelete: true
               networkInterfaces:
                - network: "global/networks/default"
       result: insertResult
   - retStep:
       return: ${insertResult}

次のコマンドを入力してワークフローをデプロイします。

gcloud workflows deploy create-vm-from-form \
    --source=create-vm-from-form.yaml \
    --location=us-central1 \
    --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com

PROJECT_NUMBER は、実際の Google Cloud プロジェクトの番号に置き換えます。プロジェクト番号を取得します。

gcloud projects describe PROJECT_ID

エンドツーエンドのフローをテストする

すべてが想定どおりに動作していることを確認するには、プロセス全体を実行してみます。

フォームを自分自身に送信し、質問に適切に回答します。

VM インスタンスの作成に使用する仕様が有効であることを確認します。有効でない場合、ワークフローの実行は失敗します。詳細については、Compute Engine の汎用マシンファミリーをご覧ください。
返信を送信するには、[送信] をクリックします。
フォームでフォームを開きます。
[回答] をクリックします。
[Google スプレッドシートで表示] をクリックします。

リンク先のスプレッドシートが開きます。
回答の行で、[承認済みですか？] チェックボックスをオンにします。
Apps Script プロジェクトを開きます。
[実行] をクリックします。

トリガーが実行され、ステータスが Completed と表示されます。
create-vm-from-form ワークフローが正常に完了したことを確認します。
コンソール
1. Google Cloud コンソールの [ワークフロー] ページに移動します。
  
  [ワークフロー] に移動
2. [ワークフロー] ページで [create-vm-from-form] ワークフローをクリックし、詳細ページに移動します。
3. [ワークフローの詳細] ページで、特定の実行の詳細を取得するには、該当する実行 ID をクリックします。
  
  [実行状態] は [成功] になり、入力ペインにリクエストした VM 仕様が表示されます。
gcloud
ワークフローの実行試行のリストを取得します。
```
gcloud workflows executions list create-vm-from-form
```
結果の例を以下に示します。
```
NAME: projects/918619793306/locations/us-central1/workflows/create-vm-from-form/executions/d8947ecb-9ccb-4ea1-ba10-e5c10414e3be
STATE: SUCCEEDED
START_TIME: 2023-01-24T15:07:40.404741791Z
END_TIME: 2023-01-24T15:07:55.649373625Z
```
新しい VM が想定どおりに作成されたことを確認します。
コンソール
Google Cloud コンソールで [VM インスタンス] ページに移動します。

[VM インスタンス] に移動

VM インスタンスが、実行中であることを示すステータスとともに表示されます。
gcloud
プロジェクトのすべてのゾーンにあるすべての VM の集計リストを取得します。
```
gcloud compute instances list
```
VM インスタンスが、実行中であることを示すステータスとともに表示されます。

gcloud compute instances list コマンドの詳細については、リファレンスページをご覧ください。

クリーンアップ

このチュートリアル用に新規プロジェクトを作成した場合は、そのプロジェクトを削除します。既存のプロジェクトを使用し、このチュートリアルで変更を加えずに残す場合は、チュートリアル用に作成したリソースを削除します。

プロジェクトを削除する

課金をなくす最も簡単な方法は、チュートリアル用に作成したプロジェクトを削除することです。

プロジェクトを削除するには:

注意: プロジェクトを削除すると、次のような影響があります。

プロジェクト内のすべてのものが削除されます。このドキュメントのタスクで既存のプロジェクトを使用した場合、それを削除すると、そのプロジェクトで行った他の作業もすべて削除されます。
カスタムプロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタムプロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（たとえば、appspot.com）を保持するには、プロジェクト全体ではなくプロジェクト内の選択したリソースだけを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て上限を超えないようにすることができます。

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

Google スプレッドシートからワークフローをトリガーする

目標

費用

始める前に

コンソール

gcloud

VM インスタンスをリクエストするフォームを作成する

スプレッドシートをフォームにリンクする

Apps Script を使用して Google スプレッドシートを拡張する

VM インスタンスを作成するワークフローをデプロイする

Console

gcloud

エンドツーエンドのフローをテストする

コンソール

gcloud

コンソール

gcloud

クリーンアップ

プロジェクトを削除する

このチュートリアルで作成したリソースを削除する

次のステップ