REST Resource: spreadsheets.values

Zasób: ValueRange

Dane w zakresie arkusza kalkulacyjnego.

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

string

Zakres ujęty w notacji A1. W przypadku danych wyjściowych zakres ten wskazuje cały żądany zakres, mimo że wartości nie obejmują końcowych wierszy ani kolumn. Przy dodawaniu wartości to pole przedstawia zakres, do którego należy wyszukać tabelę, do której wartości zostaną dołączone.

majorDimension

enum (Dimension)

Główny wymiar wartości.

Jeśli dane wyjściowe arkusza mają wartość 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]].

Jako dane wejściowe naciśnij range=A1:B2,majorDimension=ROWS, a pole [[1,2],[3,4]] ustawi A1=1,B1=2,A2=3,B2=4. Jeśli używasz parametru range=A1:B2,majorDimension=COLUMNS, ustawienie [[1,2],[3,4]] ustawi A1=1,B1=3,A2=2,B2=4.

Jeśli podczas pisania to pole nie jest skonfigurowane, domyślnie przyjmuje się wartość ROWS.

values[]

array (ListValue format)

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

W przypadku danych wyjściowych puste końcowe wiersze i kolumny nie zostaną uwzględnione.

Obsługiwane typy wartości wejściowych to: wartość logiczna, ciąg znaków i liczba zmiennoprzecinkowa. Wartości null zostaną pominięte. Aby w komórce ustawić pustą wartość, jako wartość ciągu ustaw pusty ciąg znaków.

Metody

append

Dodaje 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óry pasuje do określonych filtrów danych.

batchUpdate

Ustawia wartości w jednym lub kilku zakresach arkusza kalkulacyjnego.

batchUpdateByDataFilter

Ustawia wartości w jednym lub kilku zakresach 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.