REST Resource: spreadsheets.values

Ресурс: диапазон значений

Данные в пределах диапазона электронной таблицы.

Представление JSON
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Поля
range

string

Диапазон, покрываемый значениями, в нотации A1 . Для выходных данных этот диапазон указывает весь запрошенный диапазон, даже если значения исключают конечные строки и столбцы. При добавлении значений это поле представляет диапазон для поиска таблицы, после которого значения будут добавлены.

majorDimension

enum ( Dimension )

Основное измерение значений.

Для вывода, если данные электронной таблицы: A1=1,B1=2,A2=3,B2=4 , то запрос range=A1:B2,majorDimension=ROWS вернет [[1,2],[3,4]] , тогда как запрос range=A1:B2,majorDimension=COLUMNS вернет [[1,3],[2,4]] .

Для ввода с range=A1:B2,majorDimension=ROWS тогда [[1,2],[3,4]] установит A1=1,B1=2,A2=3,B2=4 . Если range=A1:B2,majorDimension=COLUMNS тогда [[1,2],[3,4]] установит A1=1,B1=3,A2=2,B2=4 .

При записи, если это поле не установлено, по умолчанию оно равно ROWS.

values[]

array ( ListValue format)

Данные, которые были прочитаны или должны быть записаны. Это массив массивов, внешний массив представляет все данные, а каждый внутренний массив представляет основное измерение. Каждый элемент внутреннего массива соответствует одной ячейке.

Для вывода пустые конечные строки и столбцы не будут включены.

Для ввода поддерживаются следующие типы значений: bool, string и double. Нулевые значения будут пропущены. Чтобы установить в ячейке пустое значение, задайте для строкового значения пустую строку.

Методы

append

 Добавляет значения в электронную таблицу.

batchClear

 Удаляет один или несколько диапазонов значений из электронной таблицы.

batchClearByDataFilter

 Удаляет один или несколько диапазонов значений из электронной таблицы.

batchGet

 Возвращает один или несколько диапазонов значений из электронной таблицы.

batchGetByDataFilter

 Возвращает один или несколько диапазонов значений, соответствующих указанным фильтрам данных.

batchUpdate

 Задает значения в одном или нескольких диапазонах электронной таблицы.

batchUpdateByDataFilter

 Задает значения в одном или нескольких диапазонах электронной таблицы.

clear

 Удаляет значения из электронной таблицы.

get

 Возвращает диапазон значений из электронной таблицы.

update

 Задает значения в диапазоне электронной таблицы.