REST Resource: spreadsheets.values

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

string

Zakres zakresu wartości w notacji A1. W przypadku danych wyjściowych ten zakres obejmuje cały żądany zakres, mimo że wartości nie uwzględniają końcowych wierszy i kolumn. Podczas dołączania wartości to pole określa zakres, po którym ma zostać wyszukana tabela. Wartości te zostaną dodane do tabeli.

enum (Dimension)

Główny wymiar wartości.

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

W przypadku danych wejściowych, przy użyciu funkcji range=A1:B2,majorDimension=ROWS, [[1,2],[3,4]] ustawi wartość A1=1,B1=2,A2=3,B2=4. Jeśli wybierzesz opcję range=A1:B2,majorDimension=COLUMNS, [[1,2],[3,4]] ustawi wartość A1=1,B1=3,A2=2,B2=4.

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

array (ListValue format)

Dane, które zostały odczytane lub do zapisania. To jest tablica macierzy: tablica zewnętrzna reprezentująca 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 danych wyjściowych nie uwzględnimy pustych końcowych wierszy ani kolumn.

W przypadku danych wejściowych obsługiwane są następujące typy wartości: wartość logiczna, ciąg znaków i liczba zmiennoprzecinkowa. Wartości null zostaną pominięte. Aby ustawić w komórce pustą wartość, ustaw pusty ciąg znaków.