G-gen の西田です。単一の Google Apps Script（GAS）を、複数のスプレッドシートで共用する方法について解説します。

はじめに

当記事について

当記事では、複数のスプレッドシートで同じ Google Apps Script（GAS）プログラムを使用する方法について解説します。作成した GAS プログラムは、ライブラリとしてデプロイすることで、複数のスプレッドシートファイルから呼び出して使用することができます。

この方法のメリットは、ソースコードの管理負荷を軽減しながら複数の部門などに共通のプログラムを提供できる点です。

今回の検証では、スプレッドシートに入力されている宛先リストに一斉にメール送信をするプログラムを、利用部門ごとに管理される宛先リストやメール文面で使用する例を紹介します。

Google Apps Script（GAS）とは

Google Apps Script（GAS）は、Google Workspace と統合されたアプリケーションを簡単に作成できるアプリケーション開発プラットフォームです。JavaScript でソースコードを記述します。GAS では、スプレッドシート、Gmail、カレンダーなどの Google Workspace アプリ用の組み込みライブラリを使用できます。

参考 : Google Apps Script の概要
参考 : Google Apps Script (GAS) カテゴリーの記事一覧 - G-gen Tech Blog

2つの GAS 作成方法

GAS の作成方法には、2つのパターンあります。

1つは、コンテナバインドと呼ばれる方法で、スプレッドシートなどの Google アプリケーションに紐付けてスクリプトを作成する方法です。

もう1つは、スタンドアロンと呼ばれる手法で、Google アプリケーションに紐付けずにスクリプトを単体で作成します。

GAS で操作対象のスプレッドシートなどのファイルを指定する際に、スタンドアロンではファイルの URL や ID などを明示的に指定する必要があります。一方コンテナバインドでは、GAS が実行されたファイルをアクティブファイルと指定して取得することができます。

【スプレッドシート指定方法の例】

// 【コンテナバインド】バインドされたファイルをアクティブファイルとして指定できる
SpreadsheetApp.getActiveSpreadsheet();

// 【スタンドアロン】ファイルの URL や ID で直接指定する必要がある
SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/');

共用 GAS スクリプトの準備

スクリプトの作成

まずは複数のスプレッドシートで共用する GAS スクリプトを作成します。

共用の GAS は、スタンドアロンで作成して、ライブラリとしてデプロイする必要があります。検証用のソースコードは以下の通りです。

/**
 * メールを一斉送信プログラムです。リストアップされたメールアドレス宛にメールを一斉送信します。
 */
function sendEmails() {
 
  // アクティブスプレッドシートを取得
  const activeSheet       = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
 
  // 送信先対象者データの取得
  const lastRowColA       = activeSheet.getRange(activeSheet.getMaxRows(),1).getNextDataCell(SpreadsheetApp.Direction.UP).getRow();
  const recipientsValues  = activeSheet.getRange(2,1,lastRowColA-1, 3).getValues();
 
  // メール内容テンプレート文面の取得
  const subject     = activeSheet.getRange('F2').getValue().toString();
  let templateBody  = activeSheet.getRange('F3').getValue().toString();
 
  // 件名か本文のいずれかが空欄の場合は処理を終了
  if (!subject || !templateBody) {
    SpreadsheetApp.getUi().alert('件名 あるいは 本文が空欄のため、処理を終了します。');
    return;
  }
 
  // メール一斉送信
  let cnt = 0; // 送信メールカウンター
  for (let i=0; i<recipientsValues.length; i++) {
    // 変数値の取得
    let email   = recipientsValues[i][0];
    let company = recipientsValues[i][1];
    let name    = recipientsValues[i][2];
 
    // 送信先に'@'が含まれていない場合はスキップ
    if (!email.toString().includes('@')) {
      continue;
    }
 
    // メール文面の変数を置換
    let mailBody  = templateBody.replace('{会社名}', company);
    mailBody      = mailBody.replace('{氏名}', name);
    mailBody      = mailBody.replace('{電話番号}', PropertiesService.getScriptProperties().getProperty('TEL_NO'));
 
    // メール送信の実施
    GmailApp.sendEmail(email, subject, mailBody);
    cnt = cnt + 1;
  }
 
  SpreadsheetApp.getUi().alert(cnt + '件のメールを送信しました。');
}