【VBAリファレンス】Google Apps ScriptでExcel VBAのようにセル操作！数字・文字の書き込み入門

概要

Google Apps Script（GAS）は、Google Workspace（Gmail、Google スプレッドシート、Google ドキュメントなど）を自動化・拡張するためのJavaScriptベースのプログラミング言語です。特にGoogle スプレッドシートとの連携は強力で、Excel VBAに慣れ親しんだ方であれば、GASの基本的なセル操作は比較的容易に習得できるでしょう。本記事では、GASを使ってGoogle スプレッドシートのセルに数字や文字を書き込む方法を、初心者の方にも分かりやすく解説します。Excel VBAの経験がある方を念頭に置きながら、GASならではの機能や注意点にも触れていきます。

詳細解説

Google スプレッドシートの基本構造とGAS

Google スプレッドシートは、ワークシート（シート）、行、列、そしてセルという構造で成り立っています。GASでこれらの要素を操作するには、まず対象となるスプレッドシートとシートを取得する必要があります。

• SpreadsheetApp オブジェクト: GASでスプレッドシートを操作するための最も基本的なオブジェクトです。
• getActiveSpreadsheet(): 現在アクティブな（開いている）スプレッドシートを取得します。
• getSheetByName(name): シート名で特定のシートを取得します。
• getActiveSheet(): 現在アクティブなシートを取得します。

セルへの値の書き込み方法

セルに値を書き込むには、主に以下の2つの方法があります。

1. getRange(row, column).setValue(value): 行番号と列番号を指定してセルを取得し、値を設定します。
2. getRange(a1Notation).setValue(value): A1表記法（例: “A1”, “B5″）でセルを指定して値を取得し、設定します。

setValue() メソッドは、指定したセルに単一の値（数字、文字列、日付、論理値など）を書き込みます。

数字の書き込み

セルに数字を書き込むのは非常にシンプルです。setValue() メソッドに数値を直接渡すだけです。

例：1行目1列目のセル（A1）に数値「123」を書き込む場合

function writeNumber() {
  var ss = SpreadsheetApp.getActiveSpreadsheet(); // アクティブなスプレッドシートを取得
  var sheet = ss.getActiveSheet(); // アクティブなシートを取得

  // 方法1: 行番号と列番号で指定
  sheet.getRange(1, 1).setValue(123); // 1行目1列目 (A1) に 123 を書き込む

  // 方法2: A1表記法で指定
  sheet.getRange("B2").setValue(456); // B2 セルに 456 を書き込む
}

GASでは、数値として認識される文字列（例: “789”）を setValue() で書き込んだ場合も、自動的に数値として扱われます。ただし、後述する setNumberFormat() などで書式設定を行う場合は、意図した通りの結果を得るために、GAS側で数値型として扱うことが重要です。

文字（文字列）の書き込み

文字列を書き込む場合も同様に、setValue() メソッドに文字列を渡します。文字列はダブルクォーテーション（”）またはシングルクォーテーション（’）で囲む必要があります。

例：2行目3列目のセル（C2）に文字列「こんにちは」を書き込む場合

function writeString() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();

  // 方法1: 行番号と列番号で指定
  sheet.getRange(2, 3).setValue("こんにちは"); // 2行目3列目 (C2) に「こんにちは」を書き込む

  // 方法2: A1表記法で指定
  sheet.getRange("D3").setValue("Google Apps Script"); // D3 セルに「Google Apps Script」を書き込む
}

GASでは、Excel VBAのように文字列を明示的に宣言する `Dim str As String` のような構文はJavaScriptの変数宣言 `var str = “…”` に置き換わります。

日付や時刻の書き込み

日付や時刻を書き込む場合、GASでは Date オブジェクトを使用するのが一般的です。

function writeDate() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();

  var today = new Date(); // 現在の日付と時刻を取得
  sheet.getRange("E4").setValue(today); // E4 セルに現在の日付と時刻を書き込む

  var specificDate = new Date(2023, 9, 26); // 月は0から始まるため、10月は9を指定
  sheet.getRange("F5").setValue(specificDate); // F5 セルに 2023年10月26日 を書き込む
}

JavaScriptの new Date(year, monthIndex, day) コンストラクタでは、月が0から始まる（0:1月, 1:2月, …, 9:10月, 10:11月, 11:12月）点に注意が必要です。

複数のセルに一括で書き込む (発展)

Excel VBAでは Range("A1:B2").Value = Array(Array("a", "b"), Array("c", "d")) のように配列を使って一括で書き込むことがよく行われます。GASでも同様に、2次元配列を使って複数のセルに一度に値を書き込むことができます。これは、処理速度の向上に大きく貢献します。

function writeMultipleCells() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();

  // 2次元配列を作成
  var data = [
    ["ヘッダー1", "ヘッダー2"],
    [100, 200],
    [300, 400]
  ];

  // A1からB3までの範囲に2次元配列のデータを書き込む
  sheet.getRange("A1:B3").setValues(data);
}

setValues() メソッドは、getRange() で指定した範囲の行数と列数に一致する2次元配列を引数として受け取ります。

セルの書式設定

値を書き込むだけでなく、セルの書式（数値形式、通貨、パーセンテージ、日付形式など）を設定することも重要です。Excel VBAでは Range("A1").NumberFormat = "#,##0" のように指定しますが、GASでも同様の機能があります。

function formatCells() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();

  // 数値の書き込みと書式設定
  sheet.getRange("G1").setValue(12345.678);
  sheet.getRange("G1").setNumberFormat("#,##0.00"); // 3桁区切り、小数点以下2桁

  // 通貨の書式設定
  sheet.getRange("G2").setValue(9876);
  sheet.getRange("G2").setNumberFormat("$#,##0"); // 米ドル通貨形式

  // 日付の書式設定
  var dateVal = new Date();
  sheet.getRange("G3").setValue(dateVal);
  sheet.getRange("G3").setNumberFormat("yyyy年MM月dd日"); // 日本語の日付形式
}

setNumberFormat() メソッドで使用できる書式コードは、Google スプレッドシートのセルの書式設定ダイアログで利用できるものとほぼ同じです。

サンプルコード

これまでの解説をまとめた、より実践的なサンプルコードです。指定した範囲にランダムな数値を生成し、それを書き込みます。

/**
 * 指定した範囲にランダムな数値を生成して書き込むスクリプト
 */
function generateRandomNumbers() {
  // 1. アクティブなスプレッドシートとシートを取得
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getActiveSheet();

  // 2. 書き込む範囲を指定 (例: A1からC10)
  var startRow = 1;
  var startCol = 1;
  var numRows = 10;
  var numCols = 3;

  // 3. 2次元配列を準備 (GASでは setValues() で一括書き込みが効率的)
  var data = [];
  for (var i = 0; i < numRows; i++) {
    var rowData = [];
    for (var j = 0; j < numCols; j++) {
      // 0から100までのランダムな整数を生成
      var randomNumber = Math.floor(Math.random() * 101);
      rowData.push(randomNumber);
    }
    data.push(rowData);
  }

  // 4. 指定した範囲にデータを書き込む
  var targetRange = sheet.getRange(startRow, startCol, numRows, numCols);
  targetRange.setValues(data);

  // 5. 書き込んだセルの書式設定 (例: 数値形式)
  targetRange.setNumberFormat("0"); // 小数点以下を表示しない整数形式

  // 6. ヘッダー行に文字を書き込む
  sheet.getRange("A1:C1").setValue("ランダム数値データ"); // A1からC1のセルにヘッダーを書き込む
  sheet.getRange("A1:C1").merge(); // セルを結合する (A1のみに表示される)
  sheet.getRange("A1").setHorizontalAlignment("center"); // 中央揃えにする
  sheet.getRange("A1").setFontWeight("bold"); // 太字にする

  Logger.log("ランダム数値データを " + sheet.getName() + " シートの A1:" + targetRange.getA1Notation().split(":")[1] + " に書き込みました。");
}

/**
 * 特定のセルに定型文を書き込むスクリプト
 */
function writeFixedText() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("Sheet1"); // "Sheet1" という名前のシートを指定 (必要に応じて変更)

  if (!sheet) {
    Logger.log("指定されたシートが見つかりません。");
    return; // シートが見つからなければ処理を終了
  }

  // 複数のセルに決まった文字列を書き込む
  sheet.getRange("E5").setValue("これは固定のテキスト1です。");
  sheet.getRange("E6").setValue("これは固定のテキスト2です。");
  sheet.getRange("E7").setValue("処理日時: " + new Date()); // 現在の日時を追記
}

実務アドバイス

Excel VBAでの開発経験がある方にとって、GASは非常に親しみやすいツールです。しかし、いくつか注意しておきたい点があります。

• 実行権限と認可: GASは初めて実行する際に、Googleアカウントへのアクセス権限の承認を求められます。これはセキュリティ上必要なプロセスです。
• 実行時間制限: GASには無料版の場合、1回のスクリプト実行につき最長6分の実行時間制限があります。大量のデータを処理する場合や複雑なループ処理を行う場合は、この制限を意識する必要があります。
• APIの利用回数制限: Google WorkspaceのAPIには、1日あたりの利用回数制限が設けられています。頻繁にスプレッドシートにアクセスする処理は、効率化を心がけましょう。
• デバッグ: GASのデバッグは、Logger.log() を使ってログを出力するのが基本です。メニューの「実行」>「デバッグ」からログを確認できます。Excel VBAのイミディエイトウィンドウに似た感覚で利用できます。
• イベントトリガー: GASは、特定の時間（毎日AM9時など）や、スプレッドシートの変更時、フォームの送信時などに自動実行させる「トリガー」を設定できます。これにより、より高度な自動化が可能になります。
• エラーハンドリング: try...catch ブロックを使用して、予期せぬエラーが発生した場合の処理を記述することで、スクリプトの堅牢性を高めることができます。
• setValues() の活用: 繰り返しになりますが、複数のセルにデータを書き込む際は、setValue() をループで何度も呼び出すよりも、2次元配列を作成して setValues() で一括書き込みする方が格段に高速です。これは、GASのパフォーマンスチューニングにおいて最も重要なテクニックの一つです。

まとめ

Google Apps Scriptを使えば、Excel VBAのようにGoogle スプレッドシートのセルに数字や文字を簡単に書き込むことができます。SpreadsheetApp オブジェクトを起点に、getRange() でセルを指定し、setValue() や setValues() メソッドで値を設定するという基本的な流れは、Excel VBAの操作感と非常に似ています。

本記事では、基本的な値の書き込みに加え、日付の扱い、複数セルへの一括書き込み、セルの書式設定についても解説しました。これらの知識を習得することで、日々のルーチンワークを効率化したり、より高度なデータ管理システムを構築したりすることが可能になります。

GASはJavaScriptの知識があればさらに応用範囲が広がりますが、まずは今回ご紹介したような基本的なセル操作から始めて、徐々にステップアップしていくことをお勧めします。Google スプレッドシートの自動化の世界へ、ぜひ第一歩を踏み出してみてください。