REST Resource: spreadsheets.values

Ressource: ValueRange

Daten in einem Bereich der Tabelle

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

string

Der Bereich, den die Werte abdecken, in A1-Notation. In der Ausgabe gibt dieser Bereich den gesamten angeforderten Bereich an, auch wenn die Werte abschließende Zeilen und Spalten ausschließen. Beim Anhängen von Werten stellt dieses Feld den Bereich dar, in dem nach einer Tabelle gesucht wird, der die Werte dann angefügt werden.

majorDimension

enum (Dimension)

Die Hauptdimension der Werte.

Wenn die Tabellendaten A1=1,B1=2,A2=3,B2=4 lauten, wird bei einer Anfrage für range=A1:B2,majorDimension=ROWS der Wert [[1,2],[3,4]] zurückgegeben. Bei einer Anfrage für range=A1:B2,majorDimension=COLUMNS wird dagegen [[1,3],[2,4]] zurückgegeben.

Bei der Eingabe wird mit range=A1:B2,majorDimension=ROWS dann [[1,2],[3,4]] festgelegt, um A1=1,B1=2,A2=3,B2=4 zu setzen. Mit range=A1:B2,majorDimension=COLUMNS wird [[1,2],[3,4]] auf A1=1,B1=3,A2=2,B2=4 festgelegt.

Wenn dieses Feld beim Schreiben nicht festgelegt ist, wird standardmäßig ZEILEN verwendet.

values[]

array (ListValue format)

Die gelesenen oder zu schreibenden Daten. Dies ist ein Array von Arrays, wobei das äußere Array alle Daten und jedes innere Array eine Hauptdimension darstellt. Jedes Element im inneren Array entspricht einer Zelle.

Leere Zeilen und Spalten am Ende werden in der Ausgabe nicht berücksichtigt.

Für die Eingabe werden die Werttypen „bool“, „string“ und „double“ unterstützt. Nullwerte werden übersprungen. Wenn Sie eine Zelle auf einen leeren Wert setzen möchten, setzen Sie den Stringwert auf einen leeren String.

Methoden

append

Hängt Werte an eine Tabelle an.

batchClear

Löscht einen oder mehrere Wertebereiche aus einer Tabelle.

batchClearByDataFilter

Löscht einen oder mehrere Wertebereiche aus einer Tabelle.

batchGet

Gibt einen oder mehrere Wertebereiche aus einer Tabelle zurück.

batchGetByDataFilter

Gibt einen oder mehrere Wertebereiche zurück, die mit den angegebenen Datenfiltern übereinstimmen.

batchUpdate

Legt Werte in einem oder mehreren Bereichen einer Tabelle fest.

batchUpdateByDataFilter

Legt Werte in einem oder mehreren Bereichen einer Tabelle fest.

clear

Löscht Werte aus einer Tabelle.

get

Gibt einen Wertebereich aus einer Tabelle zurück.

update

Legt Werte in einem Bereich einer Tabelle fest.