REST Resource: spreadsheets.values

Zasób: ValueRange

Dane z zakresu arkusza kalkulacyjnego.

Zapis JSON
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Pola
range

string

Zakres wartości w notacji A1. W przypadku danych wyjściowych w tym zakresie widoczny jest cały żądany zakres, mimo że wartości nie zawierają końcowych wierszy ani kolumn. Podczas dodawania wartości to pole wskazuje zakres wyszukiwania tabeli, po której wartości zostaną dołączone.

majorDimension

enum (Dimension)

Główny wymiar wartości.

W przypadku danych wyjściowych arkusza kalkulacyjnego: A1=1,B1=2,A2=3,B2=4, żądanie range=A1:B2,majorDimension=ROWS zwróci wartość [[1,2],[3,4]], a żądanie range=A1:B2,majorDimension=COLUMNS zwróci wartość [[1,3],[2,4]].

W przypadku danych wejściowych: range=A1:B2,majorDimension=ROWS, a następnie [[1,2],[3,4]] ustawi A1=1,B1=2,A2=3,B2=4. W przypadku zasady range=A1:B2,majorDimension=COLUMNS wartość [[1,2],[3,4]] zostanie ustawiona na A1=1,B1=3,A2=2,B2=4.

Jeśli podczas pisania to pole nie zostanie skonfigurowane, zostanie użyta domyślna wartość ROWS.

values[]

array (ListValue format)

Dane, które zostały odczytane lub do zapisania. Jest to tablica tablic, zewnętrzna tablica reprezentująca wszystkie dane, a każda wewnętrzna tablica reprezentująca wymiar główny. Każdy element w wewnętrznej tablicy odpowiada jednej komórce.

W przypadku danych wyjściowych puste wiersze i kolumny nie będą uwzględniane.

Obsługiwane typy wartości to: bool, string i double. Wartości puste będą pomijane. Aby zmienić wartość komórki na pustą, użyj wartości pustej.

Metody

append

Dołącza wartości do arkusza kalkulacyjnego.

batchClear

Usuwa jeden lub więcej zakresów wartości z arkusza kalkulacyjnego.

batchClearByDataFilter

Usuwa jeden lub więcej zakresów wartości z arkusza kalkulacyjnego.

batchGet

Zwraca co najmniej jeden zakres wartości z arkusza kalkulacyjnego.

batchGetByDataFilter

Zwraca co najmniej 1 zakres wartości, które pasują do określonych filtrów danych.

batchUpdate

Ustawia wartości w co najmniej jednym zakresie arkusza kalkulacyjnego.

batchUpdateByDataFilter

Ustawia wartości w co najmniej jednym zakresie arkusza kalkulacyjnego.

clear

Usuwa wartości z arkusza kalkulacyjnego.

get

Zwraca zakres wartości z arkusza kalkulacyjnego.

update

Ustawia wartości w zakresie arkusza kalkulacyjnego.