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 Bei der Ausgabe gibt dieser Bereich den gesamten angeforderten Bereich an, obwohl die Werte nachgestellte Zeilen und Spalten ausschließen. Beim Anfügen von Werten steht dieses Feld für den Bereich, in dem nach einer Tabelle gesucht werden soll. Danach werden die Werte angehängt.

majorDimension

enum (Dimension)

Die Hauptdimension der Werte.

Ist die Ausgabe der Tabelle A1=1,B1=2,A2=3,B2=4, wird für die Anfrage range=A1:B2,majorDimension=ROWS der Wert [[1,2],[3,4]] und für die Anfrage range=A1:B2,majorDimension=COLUMNS der Wert [[1,3],[2,4]] zurückgegeben.

Bei der Eingabe wird mit range=A1:B2,majorDimension=ROWS für [[1,2],[3,4]] der Wert A1=1,B1=2,A2=3,B2=4 festgelegt. Mit range=A1:B2,majorDimension=COLUMNS wird dann für [[1,2],[3,4]] der Wert A1=1,B1=3,A2=2,B2=4 festgelegt.

Wenn beim Schreiben dieses Feld nicht festgelegt wird, wird standardmäßig ROWS 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.

Für die Ausgabe werden leere nachgestellte Zeilen und Spalten nicht berücksichtigt.

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

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 den angegebenen Datenfiltern entsprechen.

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.