REST Resource: spreadsheets.values

Ресурс: ValueRange

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

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

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