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, w którym występują wartości, w notacji A1. W przypadku danych zakres ten wskazuje cały żądany zakres, mimo że wartości będą wykluczać ostatnie wiersze i kolumny. Podczas dołączania wartości to pole reprezentuje zakres, w którym należy wyszukać tabelę, po której dołączane będą wartości.

majorDimension

enum (Dimension)

Główny wymiar wartości.

Jeśli dane arkusza kalkulacyjnego mają postać A1=1,B1=2,A2=3,B2=4, to żądanie range=A1:B2,majorDimension=ROWS zwróci wartość [[1,2],[3,4]], a żądanie range=A1:B2,majorDimension=COLUMNS[[1,3],[2,4]].

W przypadku danych wejściowych, gdy range=A1:B2,majorDimension=ROWS jest równe [[1,2],[3,4]], zostanie ustawiona wartość A1=1,B1=2,A2=3,B2=4. Jeśli range=A1:B2,majorDimension=COLUMNS, to [[1,2],[3,4]] będzie ustawiać A1=1,B1=3,A2=2,B2=4.

Jeśli podczas zapisywania to pole nie jest ustawione, domyślnie przyjmuje wartość ROWS.

values[]

array (ListValue format)

Dane, które zostały odczytane lub mają zostać zapisane. Jest to tablica tablic, przy czym tablica zewnętrzna reprezentuje wszystkie dane, a każda tablica wewnętrzna reprezentuje główny wymiar. Każdy element w tablicy wewnętrznej odpowiada jednej komórce.

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

W przypadku danych wejściowych obsługiwane są typy wartości: bool, string i double. Wartości null zostaną pominięte. Aby ustawić komórkę na pustą wartość, ustaw wartość ciągu na pusty ciąg znaków.

Metody

append

Dodaje wartości do arkusza kalkulacyjnego.

batchClear

Czyści z arkusza kalkulacyjnego co najmniej 1 zakres wartości.

batchClearByDataFilter

Czyści z arkusza kalkulacyjnego co najmniej 1 zakres wartości.

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

Czyści wartości z arkusza kalkulacyjnego.

get

Zwraca zakres wartości z arkusza kalkulacyjnego.

update

Ustawia wartości w zakresie arkusza kalkulacyjnego.