GAS(Google Apps Script)でシートにまとめて書き込もうとしたら、「Exception: The number of rows in the data does not match the number of rows in the range. The data has 3 but the range has 1.」という英語のエラーで止まった。setValues を使うと、とてもよく出るエラーです。
このエラーは「書き込むデータの行数と、書き込む先の範囲の行数が合っていない」という意味です。この記事では、原因の見分け方と、次から同じことで止まらない書き方をまとめました。
■ まず、エラーの文の数字を見る
・The data has 3 → 書き込もうとしたデータが 3 行
・the range has 1 → 書き込む先の範囲が 1 行
「rows」ではなく「columns」と出ていたら、列の数が合っていません。どちらの数が思っていたのと違うかを見ると、原因がすぐ分かります。
■ 原因 1:範囲の大きさを決め打ちしている(いちばん多い)
たとえば sheet.getRange('A2:D2').setValues(data) のように、範囲を 1 行に決めてあると、データが 3 行のときに止まります。データの数は日によって変わるので、範囲は配列の大きさから決めます。
sheet.getRange(2, 1, data.length, data[0].length).setValues(data);
getRange(始まりの行, 始まりの列, 行の数, 列の数) の形にすると、データが何行でも合います。
■ 原因 2:1 次元の配列のまま書いている
setValues に渡すのは「行の配列の配列」(2 次元の配列)です。map で値だけを取り出すと ['田中', '佐藤'] のような 1 次元の配列になり、そのままでは書けません。このときは「The parameters (String[]) don't match the method signature」という別のエラーになります。1 列で書くなら [['田中'], ['佐藤']] の形にします。
■ 原因 3:行によって列の数が違う
push で行を足していくと、ある行だけ項目が 1 つ少ない、ということが起きます。いちばん長い行に合わせて、足りないところを空欄で埋めると書けます。
■ そのまま使える関数
3 つの原因をまとめて吸収する関数です。範囲の大きさは配列から決め、1 次元の配列は 1 列に直し、列の数はいちばん長い行にそろえます。データが 0 行のときは、エラーにせず何もしません。
function writeRows(sheet, startRow, startCol, rows) {
if (!rows || rows.length === 0) {
Logger.log('書き込むデータがありません(0 行)。');
return 0;
}
// ['a', 'b'] のような 1 次元の配列は、1 列のデータ [['a'], ['b']] にする
const table = rows.map(r => Array.isArray(r) ? r : [r]);
// 列の数を、いちばん長い行にそろえる(足りないところは空欄)
const width = Math.max(...table.map(r => r.length));
if (width === 0) {
Logger.log('書き込むデータがありません(0 列)。');
return 0;
}
const fixed = table.map(r => r.concat(new Array(width - r.length).fill('')));
sheet.getRange(startRow, startCol, fixed.length, width).setValues(fixed);
return fixed.length;
}
使い方の例:「名簿」シートの A 列(名前)を、「一覧」シートの B2 から下に書き出します。
function copyNames() {
const ss = SpreadsheetApp.getActiveSpreadsheet();
const src = ss.getSheetByName('名簿');
const dst = ss.getSheetByName('一覧');
const last = src.getLastRow();
if (last < 2) return 0;
const names = src.getRange(2, 1, last - 1, 1).getValues().map(r => r[0]);
return writeRows(dst, 2, 2, names);
}
今あるコードの「getRange(...).setValues(データ)」を「writeRows(シート, 始まりの行, 始まりの列, データ)」に置きかえるだけで使えます。最後の行の下に足したいときは、始まりの行を sheet.getLastRow() + 1 にします。
■ つまずきやすいところ
・1 行だけ書きたいときは、かっこを二重にして [['りんご', 100, 3]] と書きます(かっこが 1 つだと、上の関数では 1 列 3 行として書かれます)
・前より少ない行を書くと、前の行が下に残ります。書く前に、前のデータの範囲を clearContent() で消しておくと安心です
・データが 0 行のときに getRange の行の数を 0 にすると、別のエラーになります。上の関数のように、先に 0 行かどうかを確かめます
・試すときは、本番のシートのコピーで試すと安心です
■ 自分で直すのが大変なときは
「どの行が悪いのか分からない」「AI に作ってもらったコードが動かない」「直したら別のエラーが出た」といったときは、次の出品でお手伝いしています。
あわせて読みたい:
・GASで「Cannot read properties of null」と出るときの直し方
https://coconala.com/blogs/6357864/848320・GASで「Service invoked too many times」と出て止まるときの直し方
https://coconala.com/blogs/6357864/846754
この記事は、AI(Claude)の助けを借りて書いています。コードは、テスト用のデータで動きを確かめてから載せています。