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

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