Если вы go на странице справки для метода sheets.value.append
, вы увидите, что значения, которые вам нужно ввести, - это объект типа ValueRange
и из документации вы можете увидеть:
values[]
Данные, которые были прочитаны или должны быть записаны. Это массив массивов, внешний массив представляет все данные, а каждый внутренний массив представляет главное измерение. Каждый элемент во внутреннем массиве соответствует одной ячейке.
И почему так сделано ... ну, ваше предположение такое же, как и мое.
Наличие стандартизированного объекта для представления значений заданного диапазона (ввода или вывода) является плюсом при работе с любым API. Также в тех случаях, когда вы хотите добавить более одной строки / столбца за раз, вы можете легко это сделать, предоставив двумерный массив, когда будет столько же массивов, сколько строк / столбцов, которые вы хотите вставить (как указано в документации) .
TL; DR : 2-D массив является очень хорошим аналогом значений внутри диапазона внутри электронной таблицы.